post https://payout-gamma.cashfree.com/payout/v1/requestAsyncTransfer
Use this API to initiate an amount transfer request at Cashfree Payments. You need to provide beneficiary ID, amount, and transfer ID. This is an async transfer request.
Version 2 APIs
We provide version 2 APIs for Payouts that benefits you in multiple ways.
Once you trigger the requestAsyncTransfer API, Cashfree Paymets verifies your request and returns the 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 Payments.
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.
Please use this Authorization token in headers to call any payout API (Refresh this page if the token is expired)
Click to view the response codes.
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. |
| 403 | ERROR | Token is not valid |
| 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. |
| 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. |
| 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. |
| 409 | ERROR | Transfer Id already exists. |
| 404 | ERROR | Beneficiary does not exist. |
| 422 | ERROR | Beneficiary details not valid. |
| 422 | ERROR | No Bank account or IFSC associated with the beneficiary. |
| 412 | ERROR | Not enough available balance in the account. |
| 412 | ERROR | Please wait 30 minutes after adding the beneficiary. |
| 412 | ERROR | Transfer amount is less than minimum amount of Rs. 100. |
| 412 | 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. |
| 422 | ERROR | Transfer request to paytm wallet failed. |
| 400/520 | ERROR | Transfer attempt failed at the bank. |
| 520 | ERROR | Transfer request triggered.No response from bank. |
| 403 | ERROR | Transfer to this beneficiary not allowed. |
| 412 | ERROR | Transfer limit for beneficiary exceeded. |
| 412 | ERROR | Transfer limit for your account exceeded. |
| 412 | ERROR | Invalid transfer mode passed in the request. |
| 412 | ERROR | Transfer mode not enabled for the account. |
| 412 | ERROR | Invalid Tag passed in the request. |