post https://payout-api.cashfree.com/payout/v1/requestTransfer
Use this API to initiate an amount transfer request at Cashfree by providing beneficiary id, amount, and transfer id. This is a sync transfer request.
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.
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. |
| 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. |
| 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. |
| 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. |
| 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. |