Credit bank account
Header Parameters
X-Auth-User-IDstring Required
MatchMove provided ID for the user.
Authorizationstring
Body Parameters
bank_account_idstring Required
client_ref_idstring Required
amountnumber Required
currencystring Required
The currency of the application.
purpose_of_transferstring Required
Response
200
Object
Success
Response Attributes
idstring
client_ref_idstring
Client Reference ID
amountnumber
Transfer Amount
feenumber
Transfer fee
currencystring
Transfer Currency
payment_reference_idstring
Internal Generated Reference ID
ref_idstring
Transaction Reference ID
unique_payment_idstring
Bank Transaction Reference ID
purpose_of_transferstring
Reason of Transfer
transfer_typestring
Type of Bank Transfer
statusstring
Status of Bank Transfer
| Status | Description |
|---|---|
| success | Status of transaction when fund transfer is successful and completed by bank |
| pending | Status of transaction when fund transfer is in progress. The system will wait for acknowledgement from the bank |
| reversed | Status of transaction when fund transfer is rejected by bank and a required reversal is automatically performed |
| failed | Status of transaction when fund transfer failed due to ce... |
Enum values:
successpendingreversedfaileddescriptionstring
bank_accountobject
Bank Account Details
Show child attributes
created_atstring
Bank Transfer Created Date
updated_atstring
Bank Transfer Updated Date
400
Object
Bad Request
| Code | Description | Examples/Notes |
| :--- | :---------- | :---------- |
| resource_va_error | Error: :error_message | Invalid Account |
| | | System debit limit reached |
| | | This facility is temporarily blocked |
| | | Receiving party currently not available |
| | | Amount is greater than the maximum transaction amount allowed |
| | | Validation error : OP : Credit on the selected fund category of the card/wallet must be greater than or equal to the amount being deducted#resource_card_fund_category_transfer_minimum_debit_limit_reached |
| | | Validation error : OP : User is currently inactive#resource_user_inactive |
| | | Validation error : OP : User not found or does not exist |
| | | Validation error : OP : User currently has a pending transaction#resource_user_lockout |
| | | Daily transactional limit reached |
| | | Program account fund is insufficient. |
| beneficiary_restricted | Transaction not allowed as beneficiary is not active. | Transaction not allowed as beneficiary is not active. |
| beneficiary_under_cooling_period | Transaction is not allowed as beneficiary is under cooling period. Please try again once active | Transaction is not allowed as beneficiary is under cooling period. Please try again once active |
Response Attributes
codeinteger Required
descriptionstring Required
linkstring Required
401
Object
Unauthorized request
| Code | Description | Examples/Notes |
| :--- | :---------- | :---------- |
| resource_va_error | Error: :error_message | error_message are dynamic errors which represents the 401 errors |
Response Attributes
codeinteger Required
descriptionstring Required
linkstring Required
403
Object
Forbidden
| Code | Description | Examples/Notes |
| :--- | :---------- | :---------- |
| resource_va_error | Error: :error_message | error_message are dynamic errors which represents the 403 errors |
| | | Transfer out feature is blocked for this program |
| enity_blocked_risk_threshold_exceeded | Entity '{entity}.{attribute}' requested for evaluation is blacklisted | Entity 'virtual_account_source.bank_account_number' requested for evaluation is blacklisted |
| | | Entity 'virtual_account_source.bank_holder_name' requested for evaluation is blacklisted |
| | | Entity 'virtual_account_source.bank_code' requested for evaluation is blacklisted |
| | | Entity 'virtual_account_beneficiary.bank_account_number' requested for evaluation is blacklisted |
| | | Entity 'virtual_account_beneficiary.bank_holder_name' requested for evaluation is blacklisted |
| | | Entity 'virtual_account_beneficiary.bank_code' requested for evaluation is blacklisted |
| risk_management_engine_error | | An exception occurred while checking whether the entity is blacklisted or not |
Response Attributes
codeinteger Required
descriptionstring Required
linkstring Required
404
Object
Resource not found
| Code | Description | Examples/Notes |
| :--- | :---------- | :---------- |
| resource_va_error | Error: :error_message | error_message are dynamic errors which represents the 404 errors |
Response Attributes
codeinteger Required
descriptionstring Required
linkstring Required
500
Object
Internal server Error
| Code | Description |
| :--- | :---------- |
| resource_va_service_error | Unable to process the request due to the risk service unavailability. |
Response Attributes
codeinteger Required
descriptionstring Required
linkstring Required
502
Object
Bad Gateway
Response Attributes
codeinteger Required
descriptionstring Required
linkstring Required
503
Object
External Service Error
Response Attributes
codeinteger Required
descriptionstring Required
linkstring Required
504
Object
Gateway timeout
Response Attributes
codeinteger Required
descriptionstring Required
linkstring Required
Was this section helpful?
Response
Was this section helpful?