Standard Transfer Sync v1.2

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.

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)


Version 2 APIs

We provide version 2 APIs for Payouts that benefits you in multiple ways.

Click 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.-
201ERRORTransfer request triggered.No response from bank.-
202PENDINGRequest received. Please check status after some time.-
400ERRORMode Not valid for Beneficiary.Enter a different transfer mode for the beneficiary.
400ERRORTransfer Id already exists.Enter a different transfer ID.
400ERRORNot enough available balance in the account.Retry with sufficient balance in the account.
400ERRORPlease wait 30 minutes after adding the beneficiary.-
400ERRORTransfer amount is less than minimum amount of Rs. 100.Enter a transfer amount that is equal to or more than Rs. 100.
400ERRORTransfer amount is greater than the maximum amount of Rs.100000.Enter a transfer amount that is equal to or less than Rs. 100000.
400ERRORTransfer request to paytm wallet failed.Retry the request with a different transfer mode.
400ERRORTransfer attempt failed at the bank.
400ERRORTransfer to this beneficiary not allowed.Enter a different beneficiary ID.
400ERRORTransfer amount is less than minimum amount of Rs.1Enter a transfer amount that is equal to or more than Rs. 1.
400ERRORTransfer limit for your account exceeded.
400ERRORTransfer mode not enabled for the account.
400ERRORSpecified paymentInstrumentId not available.Enter a valid payment instrument ID.
400ERRORSpecified paymentInstrumentId not valid for this payment mode.Enter a valid payment instrument ID.
400ERRORMultiple PaymentInstruments available for this payment mode.
400ERRORTransfer limit for beneficiary exceeded.
403ERRORToken is not validVerify the generated token.
403ERRORIP not whitelistedWhitelist the IP address.
404ERRORBeneficiary does not exist.Enter a valid beneficiary ID.
412ERRORPlease provide a valid transferId.Enter a valid transfer ID.
422ERRORPlease provide a valid beneId.Enter a valid beneficiary ID.
422ERRORInvalid bank account number or IFSC provided.Enter a valid bank account number and IFSC.
422ERRORInvalid IFSC code provided for bank account.Enter a valid IFSC.
422ERRORInvalid Amount Passed.Only 2 decimal places are allowed.
422ERRORPlease provide a valid transferId.Enter a valid transfer ID.
422ERRORRemarks is invalid.Enter any remarks of a maximum of 70 alphanumeric characters and white spaces.

Click Try It! to start a request and see the response here!