post https://payout-api.cashfree.com/payout/v1/directTransfer
Use this API to initiate amount transfers directly to the beneficiary account via a bank transfer or UPI. You can add the beneficiary details in the same API request.
Click here to view all 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 the beneficiary bank. |
| 201 | PENDING | Transfer request pending at the bank. |
| 202 | PENDING | Request received. Please check the status after some time. |
| 400/520 | ERROR | Transfer attempt failed at the bank. |
| 400 | ERROR | The transfer amount is greater than the maximum amount of Rs.100000. |
| 400 | ERROR | The transfer amount is less than the minimum amount of Rs. 1. |
| 403 | ERROR | The token is not valid |
| 403 | ERROR | APIs not enabled. Please reach out to [email protected] |
| 403 | ERROR | IP not whitelisted |
| 403 | ERROR | This feature is not available for your account. |
| 403 | ERROR | Transfer to this beneficiary is not allowed. |
| 403 | ERROR | Transfer mode is not available for your account. |
| 404 | ERROR | The beneficiary does not exist. |
| 409 | ERROR | Transfer Id already exists. |
| 412 | ERROR | Token missing in the request. |
| 412 | ERROR | BeneId missing in the request. |
| 412 | ERROR | The amount missing in the request. |
| 412 | ERROR | TransferId missing in the request. |
| 412 | ERROR | Not enough available balance in the account. |
| 412 | ERROR | Please wait 30 minutes after adding the beneficiary. |
| 412 | ERROR | Invalid Tag passed in the request. |
| 412 | ERROR | Transfer mode is not enabled for the account. |
| 412 | ERROR | Invalid transfer mode passed in the request. |
| 412 | ERROR | The transfer limit for your account was exceeded. |
| 412 | ERROR | Transfer limit for beneficiary exceeded. |
| 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. |
| 422 | FAILED | Beneficiary details are missing in the request. |
| 422 | ERROR | Beneficiary details are not valid. |
| 422 | ERROR | No Bank account or IFSC is associated with 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. |
| 520 | ERROR | Transfer request triggered.No response from the bank. |
Note: If you are attempting to create a transfer in the Sandbox environment, you can obtain the test data details from this link.