post https://payout-gamma.cashfree.com/payout/v1.2/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 Payments 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.
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 | Next Action |
|---|---|---|---|
| 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 | Transfer amount is less than minimum amount of Rs.1 | Enter a transfer amount that is equal to or more than Rs. 1. |
| 400 | ERROR | Not enough available balance in the account. | Retry with sufficient balance in the account. |
| 400 | ERROR | Transfer Id already exists. | Enter a different transfer ID. |
| 400 | ERROR | Please wait 30 minutes after adding the beneficiary. | - |
| 400 | ERROR | Transfer amount is less than minimum amount of Rs. 100. | Enter a transfer amount that is equal to or more than Rs. 100. |
| 400 | ERROR | Transfer amount is greater than the maximum amount of Rs.100000. | Enter a transfer amount that is equal to or less than Rs. 100000. |
| 400 | ERROR | Transfer attempt failed at the bank. | |
| 400 | ERROR | Transfer to this beneficiary not allowed. | Enter a different beneficiary ID. |
| 400 | ERROR | Transfer limit for your account exceeded. | |
| 400 | ERROR | Transfer limit for beneficiary exceeded. | |
| 403 | ERROR | Token is not valid | Verify the generated token. |
| 404 | ERROR | Beneficiary does not exist. | Enter a valid beneficiary ID. |
| 412 | ERROR | Transfer mode not enabled for the account. | |
| 422 | ERROR | Please provide a valid beneId | Enter a valid beneficiary ID. |
| 422 | ERROR | Invalid Amount Passed.Only 2 decimal places are allowed. | Enter an amount with a maximum of only 2 decimal places. |
| 422 | ERROR | Please provide a valid transferId. | Enter a valid transfer ID. |
| 422 | ERROR | Invalid IFSC code provided for bank account. | Enter a valid IFSC. |
| 422 | ERROR | Invalid bank account number or IFSC provided. | Enter a valid bank account number and IFSC. |