Direct Transfer V1.2

Use this API to initiate amount transfers directly to the beneficiary account via phone number, bank transfer, or UPI. You can add the beneficiary details in the same API request.


Version 2 APIs

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

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

Click here to view all 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.-
400ERRORMultiple PaymentInstruments available for this payment mode.-
400ERRORSpecified paymentInstrumentId not valid for this payment mode.-
400ERRORSpecified paymentInstrumentId not available.Enter a different paymentInstrumentId.
400/520ERRORTransfer attempt failed at the bank.-
403ERRORToken is not validVerify the generated token
403ERRORIP not whitelistedWhitelist the IP address
403ERRORTransfer to this beneficiary not allowed.Enter different beneficiary details
403ERRORThis feature is not available for your account.
403ERRORTransfer mode is not available for your account.Enter a different transfer mode.
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.
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.
412ERRORTransfer limit for beneficiary exceeded.
412ERRORTransfer limit for your account exceeded.
412ERRORNot enough available balance in the account.Retry with sufficient balance in your account.
412ERRORInvalid Tag passed in the request.
412ERRORTransfer mode not enabled for the account.
412ERRORInvalid transfer mode passed in the request.
422ERRORInvalid amount passed.Enter a valid transfer amount.
422ERRORInvalid transferId passed.Enter a valid transferId.
422ERRORNo Payee Virtual Address associated with the beneficiary.
422ERRORRemarks can have only numbers, alphabets and whitespaces.
422ERRORBeneficiary details not valid.Enter valid beneficiary details.
422ERRORNo Bank account or IFSC associated with the beneficiary.Enter valid bank account details of the beneficiary.
422ERRORTransfer request to paytm wallet failed.
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.
520ERRORTransfer request triggered.No response from bank.
Click Try It! to start a request and see the response here!