Transfers v1.2

Transfer funds to your beneficiaries through bank transfers, Paytm, Amazon Pay, UPI, IMPS, and NEFT. The version 1.2 transfer APIs include paymentInstrumentId as one of the body parameters.

You can perform the following tasks using the transfers API:

  • Transfer money to your beneficiaries accounts through Sync, Async, Direct, and Batch APIs.
  • Check the status of each transfer using the referenceId or transferId.

The flow diagram will help you understand the different transfer APIs and their use cases.

Learn how each API functions using the following table and use the best-suited API for your transactions.

Transfer SyncTransfer AsyncDirect TransferBatch Transfer
FunctionalityInitiate an amount transfer requestInitiate an amount transfer requestInitiate an amount transfer request directly to the beneficiary not added in your Payouts account (add beneficiary details in the API request)Initiate amount transfer request to multiple beneficiaries
Sync / Async SyncAsyncAsyncAsync
UTR / Cashfree Reference ID Both UTR and Cashfree Reference IDCashfree Reference IDCashfree Reference IDCashfree Reference ID
Required Body ParamsbeneId
amount
transferId
beneId
amount
transferId
amount
transferId
transferMode
beneDetails
batchTransferId
batchFormat
Default Transfer ModeBank TransferBank TransferNot ApplicableNot Applicable
Available Transfer ModesBank, UPI, Paytm, Amazon Pay,Bank, UPI, Paytm, Amazon Pay, CardBank, UPI, Paytm, Amazon Pay, Card, IMPS, NEFTBank, UPI, Paytm, Amazon Pay
Response Time9.77 s25.0 ms9.04 s182 ms
Transactions VolumeLowHigh: up to 1000 transactions per minuteHigh: up to 1000 transactions per minuteHigh: up to 1000 transactions per minute

Transfers APIs

The version 1.2 APIs include paymentInstrumentId as one of the body parameters. Find the list of transfer APIs below:


What does the response parameter 'acknowledged' mean?

The acknowledged parameter value conveys if the beneficiary received the funds by checking its value. Ack = 1 or 0 . 1 denotes the beneficiary received funds, and 0 denotes the beneficiary had not received funds.

The cash flow happens as explained below:

  1. Debit: The debit of the transfers happens on the remitter account. After a successful debit, the beneficiary bank does further processing. When only the debit is successful, Ack = 0.

  2. Credit: The beneficiary bank credits the fund to the account. The transfer is sent from the remitter bank to the beneficiary bank after a successful debit. When the credit to the end beneficiary is successful, Ack = 1.

To confirm the status of a payout, you need to check the acknowledged parameter value. If the value is 1, you can mark the transfer as successful. However, if the value is 0, you must either wait for the TRANSFER_ACKNOWLEDGED webhook event or use the Get Transfer Status API and confirm the acknowledged value.