post https://payout-gamma.cashfree.com/payout/v1/requestTransfer
Use this API to initiate an amount transfer request at Cashfree Payments. You need to provide beneficiary ID, amount, and transfer ID. This is a sync transfer request.
Version 2 APIs
We provide version 2 APIs for Payouts that benefits you in multiple ways.
Once you trigger the requestTransfer API, the transfer to the beneficiary account will be attempted immediately and the bank's reference number will be returned in the API response. The median time for the response is 2 to 5 seconds.
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 | 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 | Verify the generated token. |
| 403 | ERROR | IP not whitelisted | Whitelist the IP address. |
| 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. | Enter a valid beneficiary ID. |
| 412 | ERROR | Amount missing in the request. | Enter a valid transfer amount. |
| 412 | ERROR | TransferId missing in the request. | Enter a valid transfer ID. |
| 422 | ERROR | Invalid amount passed. | Enter a valid transfer amount. |
| 422 | ERROR | Invalid transferId passed. | Enter a valid transfer ID. |
| 422 | ERROR | No Payee Virtual Address associated with the beneficiary. | |
| 422 | ERROR | Remarks can have only numbers, alphabets and whitespaces. | Enter any remarks of a maximum of 70 alphanumeric characters and white spaces. |
| 409 | ERROR | Transfer Id already exists. | Enter a different transfer ID. |
| 404 | ERROR | Beneficiary does not exist. | Enter valid beneficiary details. |
| 422 | ERROR | Beneficiary details not valid. | Enter valid beneficiary details. |
| 422 | ERROR | No Bank account or IFSC associated with the beneficiary. | Enter valid bank account details. |
| 412 | ERROR | Not enough available balance in the account. | Retry with sufficient 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. | Enter a transfer amount that is equal to or more than Rs. 100. |
| 412 | 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. |
| 422 | ERROR | Invalid IFSC code provided for bank account. | Enter valid bank account details. |
| 422 | ERROR | Invalid bank account number or IFSC provided. | Enter a valid bank account number and IFSC. |
| 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. | Enter a different beneficiary ID. |
| 400 | 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. |