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 phone number, bank transfer, or UPI.

📘

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 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.
Language
Authorization
Header
URL
Click Try It! to start a request and see the response here!