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.
Click to view the response codes.
Response Codes
Sub Code | Status | Message |
---|---|---|
200 | SUCCESS | Transfer completed successfully. |
201 | PENDING | 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. |
403 | ERROR | Token is not valid |
422 | ERROR | Please provide a valid beneId |
400 | ERROR | Transfer amount is less than minimum amount of Rs.1 |
422 | ERROR | Invalid Amount Passed.Only 2 decimal places are allowed. |
422 | ERROR | Please provide a valid transferId. |
400 | ERROR | Transfer Id already exists. |
404 | ERROR | Beneficiary does not exist. |
400 | ERROR | Not enough available balance in the account. |
400 | ERROR | Please wait 30 minutes after adding the beneficiary. |
400 | ERROR | Transfer amount is less than minimum amount of Rs. 100. |
400 | ERROR | Transfer amount is greater than the maximum amount of Rs.100000. |
422 | ERROR | Invalid IFSC code provided for bank account. |
422 | ERROR | Invalid bank account number or IFSC provided. |
400 | ERROR | Transfer attempt failed at the bank. |
400 | ERROR | Transfer to this beneficiary not allowed. |
400 | ERROR | Transfer limit for beneficiary exceeded. |
400 | ERROR | Transfer limit for your account exceeded. |
412 | ERROR | Transfer mode not enabled for the account. |