Direct Transfer

Use this API to initiate an amount transfer request directly to the beneficiary not in the database. You can add the beneficiary details in the API request. Transfer directly to the beneficiary account via a bank transfer or UPI.

Please use this Authorization token in headers to call any payout API (Refresh this page if the token is expired)

Click here to view the response codes.

Response Codes

Sub CodeStatusMessageNext Action
200SUCCESSTransfer completed successfully.-
201SUCCESSTransfer Scheduled for next working day.-
201PENDINGAwaiting confirmation from beneficiary bank.-
201PENDINGTransfer request pending at the bank.-
202PENDINGRequest received. Please check status after some time.-
400/520ERRORTransfer attempt failed at the bank.-
403ERRORToken is not validVerify the generated token.
403ERRORIP not whitelistedWhitelist the IP address.
403ERRORThis feature is not available for your account.-
403ERRORTransfer mode is not available for your account.Enter a different transfer mode.
403ERRORTransfer to this beneficiary not allowed.Enter different beneficiary details.
404ERRORBeneficiary does not exist.Enter a valid beneficiary ID.
409ERRORTransfer Id already exists.Enter a different transfer ID.
412ERRORToken missing in the request.Enter a valid token in the API request.
412ERRORBeneId missing in the request.Enter a valid beneficiary ID.
412ERRORAmount missing in the request.Enter a valid transfer amount.
412ERRORTransferId missing in the request.Enter a valid transfer ID.
412ERRORInvalid Tag passed in the request.
412ERRORInvalid transfer mode passed in the request.
412ERRORTransfer mode not enabled for the account.
412ERRORTransfer limit for your account exceeded.
412ERRORTransfer limit for beneficiary exceeded.
412ERRORNot enough available balance in the account.Retry with sufficient balance in your account.
412ERRORPlease wait 30 minutes after adding the beneficiary.-
412ERRORTransfer amount is less than minimum amount of Rs. 100.Enter a transfer amount that is equal to or more than Rs. 100.
412ERRORTransfer amount is greater than the maximum amount of Rs.100000.Enter a transfer amount that is equal to or less than Rs. 100000.
422ERRORInvalid IFSC code provided for bank account.Enter a valid IFSC for the provided bank account details.
422ERRORInvalid bank account number or IFSC provided.Enter valid bank account details.
422ERRORTransfer request to paytm wallet failed.
422ERRORNo Bank account or IFSC associated with the beneficiary.Enter valid bank account details of the beneficiary.
422ERRORInvalid transferId passed.Enter a valid transferId.
422ERRORBeneficiary details not valid.Enter valid beneficiary details.
422ERRORRemarks can have only numbers, alphabets and whitespaces.-
422ERRORInvalid amount passed.Enter a valid transfer amount.
422ERRORNo Payee Virtual Address associated with the beneficiary.
520ERRORTransfer request triggered.No response from bank.
Body Params

Request body to transfer money to a beneficiary using bank account details

double
required

Amount to be transferred. Amount should be greater that INR 1.00. Decimals are allowed.

string
required

A unique ID to identify this transfer. Alphanumeric characters and underscores are allowed (40 character limit).

string
required

It is the mode of transfer. Allowed values are: banktransfer, neft, imps, rtgs, upi, paytm, and amazonpay. The default transferMode is banktransfer.

string

Additional Remarks, if required.

object
required

Object with the beneficiary details to whom amount is to be transferred

Headers
string

Request id for the API call. Can be used to resolve tech issues. Communicate this in your tech related queries to cashfree

Responses

Language
Credentials
URL
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Experience the all-new Cashfree Payments Docs! Faster, smarter, and easier to navigate. Check it out here!🎉