Cashfree Payments Developer Documentation

This API will be retired soon. Please plan to migrate to the latest version, Transfers V2.

Once you trigger the requestAsyncTransfer API, Cashfree Payments verifies your request and returns the Cashfree referenceId. The transfer to beneficiary account will be attempted within the next 60 seconds and you may query the transfer status after 60 seconds.

Use this API to process very high volumes.

Benefits:

The API response is much faster for the async transfer endpoint. The async transfer response takes <100 ms as compared to a median value of 2-5 sec for the sync payout transfer API.
The asynchronous API can handle a higher TPM (transactions per minute) as compared to the synchronous API. The async API allows us to handle up to 1000 transactions per minute.

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

Sub Code	Status	Message
200	SUCCESS	Transfer completed successfully.
201	SUCCESS	Transfer Scheduled for next working day.
201	PENDING	Awaiting confirmation from beneficiary bank.
201	PENDING	Transfer request pending at the bank.
202	PENDING	Request received. Please check status after some time.
403	ERROR	Token is not valid
403	ERROR	IP not whitelisted
403	ERROR	This feature is not available for your account.
403	ERROR	Transfer mode is not available for your account.
412	ERROR	Token missing in the request.
412	ERROR	BeneId missing in the request.
412	ERROR	Amount missing in the request.
412	ERROR	TransferId missing in the request.
422	ERROR	Invalid amount passed.
422	ERROR	Invalid transferId passed.
422	ERROR	No Payee Virtual Address associated with the beneficiary.
422	ERROR	Remarks can have only numbers, alphabets and whitespaces.
409	ERROR	Transfer Id already exists.
404	ERROR	Beneficiary does not exist.
422	ERROR	Beneficiary details not valid.
422	ERROR	No Bank account or IFSC associated with the beneficiary.
412	ERROR	Not enough available balance in the account.
412	ERROR	Please wait 30 minutes after adding the beneficiary.
412	ERROR	Transfer amount is less than minimum amount of Rs. 100.
412	ERROR	Transfer amount is greater than the maximum amount of Rs.100000.
422	ERROR	Invalid IFSC code provided for bank account.
422	ERROR	Invalid bank account number or IFSC provided.
422	ERROR	Transfer request to paytm wallet failed.
400/520	ERROR	Transfer attempt failed at the bank.
520	ERROR	Transfer request triggered.No response from bank.
403	ERROR	Transfer to this beneficiary not allowed.
412	ERROR	Transfer limit for beneficiary exceeded.
412	ERROR	Transfer limit for your account exceeded.
412	ERROR	Invalid transfer mode passed in the request.
412	ERROR	Transfer mode not enabled for the account.
412	ERROR	Invalid Tag passed in the request.

Headers

Authorization

string

required

Bearer auth token

Content-Type

string

required

application/json

Body

application/json

amount

number

required

Amount to be transferred. Decimal allowed (>= 1.00)

beneId

string

required

Beneficiary ID. Alphanumeric characters allowed.

transferId

string

required

A unique id to identify this transfer. Alphanumeric and underscore (_) allowed (40 character limit).

remarks

string

Additional remarks, if any. alphanumeric and white spaces allowed (70 characters limit)

transferMode

string

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

Response

200 - application/json

data

object

message

string

status

string

subCode

string

Payout APIs

V2

V1

One Escrow

Cashgram

Standard Transfer Async

Headers

Body

Response