post https://payout-api.cashfree.com/payout/v1/requestAsyncTransfer
Use this API to initiate an amount transfer request at Cashfree by providing beneficiary id, amount, and transfer id. This is an async transfer request.
Once you trigger the requestAsyncTransfer API, Cashfree verifies your request and returns the Cashfree referenceId. The transfer to beneficiary account will be attempted within the next 60 seconds and you may query the transfer status after 60 seconds.
Use this API to process very high volumes through Cashfree.
Benefits:
- The API response is much faster for the async transfer endpoint. The async transfer response takes <100 ms as compared to a median value of 2-5 sec for the sync payout transfer API.
- The asynchronous API can handle a higher TPM (transactions per minute) as compared to the synchronous API. The async API allows us to handle up to 1000 transactions per minute.
Response Codes
Sub Code | Status | Message |
---|---|---|
200 | SUCCESS | Transfer completed successfully. |
201 | SUCCESS | Transfer Scheduled for next working day. |
201 | PENDING | Awaiting confirmation from beneficiary bank. |
201 | PENDING | Transfer request pending at the bank. |
202 | PENDING | Request received. Please check status after some time. |
400/520 | ERROR | Transfer attempt failed at the bank. |
400 | ERROR | Transfer amount is greater than the maximum amount of Rs.100000. |
400 | ERROR | Transfer amount is less than minimum amount of Rs. 1. |
403 | ERROR | Token is not valid |
403 | ERROR | APIs not enabled. Please reach out to [email protected] |
403 | ERROR | Transfer to this beneficiary not allowed. |
403 | ERROR | IP not whitelisted |
403 | ERROR | This feature is not available for your account. |
403 | ERROR | Transfer mode is not available for your account. |
404 | ERROR | Beneficiary does not exist. |
409 | ERROR | Transfer Id already exists. |
412 | ERROR | Token missing in the request. |
412 | ERROR | BeneId missing in the request. |
412 | ERROR | Amount missing in the request. |
412 | ERROR | TransferId missing in the request. |
412 | ERROR | Invalid Tag passed in the request. |
412 | ERROR | Transfer mode not enabled for the account. |
412 | ERROR | Invalid transfer mode passed in the request. |
412 | ERROR | Transfer limit for your account exceeded. |
412 | ERROR | Transfer limit for beneficiary exceeded. |
412 | ERROR | Not enough available balance in the account. |
412 | ERROR | Please wait 30 minutes after adding the beneficiary. |
422 | ERROR | Invalid amount passed. |
422 | ERROR | Invalid transferId passed. |
422 | ERROR | No Payee Virtual Address associated with the beneficiary. |
422 | ERROR | Remarks can have only numbers, alphabets and whitespaces. |
422 | ERROR | Beneficiary details not valid. |
422 | ERROR | No Bank account or IFSC associated with the beneficiary. |
422 | ERROR | Invalid IFSC code provided for bank account. |
422 | ERROR | Invalid bank account number or IFSC provided. |
422 | ERROR | Transfer request to paytm wallet failed. |
520 | ERROR | Transfer request triggered.No response from bank. |