post https://payout-api.cashfree.com/payout/v1.2/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.
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. |
400 | ERROR | Not enough available balance in the account. |
400 | ERROR | Please wait 30 minutes after adding the beneficiary. |
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 |
400 | ERROR | Transfer attempt failed at the bank. |
400 | ERROR | Transfer limit for beneficiary exceeded. |
400 | ERROR | Transfer to this beneficiary not allowed. |
400 | ERROR | Transfer limit for your account exceeded. |
403 | ERROR | Token is not valid |
404 | ERROR | Beneficiary does not exist. |
409 | ERROR | Transfer Id already exists. |
412 | ERROR | Transfer mode not enabled for the account. |
422 | ERROR | Please provide a valid beneId |
422 | ERROR | Invalid Amount Passed.Only 2 decimal places are allowed. |
422 | ERROR | Please provide a valid transferId. |
422 | ERROR | Invalid IFSC code provided for bank account. |
422 | ERROR | Invalid bank account number or IFSC provided. |