post https://payout-api.cashfree.com/payout/v1.2/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 beneficiary bank. |
| 201 | PENDING | Transfer request pending at the bank. |
| 202 | PENDING | Request received. Please check status after some time. |
| 400 | ERROR | Multiple PaymentInstruments available for this payment mode. |
| 400 | ERROR | Transfer amount is less than minimum amount of Rs. 1. |
| 400 | ERROR | Specified paymentInstrumentId not valid for this payment mode. |
| 400 | ERROR | Specified paymentInstrumentId not available. |
| 400 | ERROR | Transfer amount is greater than the maximum amount of Rs.100000. |
| 400/520 | ERROR | Transfer attempt failed at the bank. |
| 403 | ERROR | Transfer to this beneficiary not allowed. |
| 403 | ERROR | APIs not enabled. Please reach out to [email protected] |
| 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. |
| 404 | ERROR | Beneficiary does not exist. |
| 409 | ERROR | Transfer Id already exists. |
| 409 | ERROR | Internal error. Please re-initiate the transfer request |
| 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. |
| 412 | ERROR | Not enough available balance in the account. |
| 412 | ERROR | Please wait 30 minutes after adding the beneficiary. |
| 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. |
| 422 | FAILED | Beneficiary details are 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. |
| 422 | ERROR | Beneficiary details not valid. |
| 422 | ERROR | No Bank account or IFSC 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 bank. |
Note: If you are attempting to create a transfer in the Sandbox environment, you can obtain the test data details from this link.