Cashfree Payments Developer Documentation

POST

payout

v1.2

requestAsyncTransfer

{
  "status": "ACCEPTED",
  "subCode": "201",
  "message": "Transfer Initiated",
  "data": {
    "referenceId": "107260"
  }
}

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	Next Action
200	SUCCESS	Transfer completed successfully.	-
201	PENDING	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.	-
400	ERROR	Transfer amount is less than minimum amount of Rs.1	Enter a transfer amount that is equal to or more than Rs. 1.
400	ERROR	Not enough available balance in the account.	Retry with sufficient balance in the account.
400	ERROR	Transfer Id already exists.	Enter a different transfer ID.
400	ERROR	Please wait 30 minutes after adding the beneficiary.	-
400	ERROR	Transfer amount is less than minimum amount of Rs. 100.	Enter a transfer amount that is equal to or more than Rs. 100.
400	ERROR	Transfer amount is greater than the maximum amount of Rs.100000.	Enter a transfer amount that is equal to or less than Rs. 100000.
400	ERROR	Transfer attempt failed at the bank.
400	ERROR	Transfer to this beneficiary not allowed.	Enter a different beneficiary ID.
400	ERROR	Transfer limit for your account exceeded.
400	ERROR	Transfer limit for beneficiary exceeded.
403	ERROR	Token is not valid	Verify the generated token.
404	ERROR	Beneficiary does not exist.	Enter a valid beneficiary ID.
412	ERROR	Transfer mode not enabled for the account.
422	ERROR	Please provide a valid beneId	Enter a valid beneficiary ID.
422	ERROR	Invalid Amount Passed.Only 2 decimal places are allowed.	Enter an amount with a maximum of only 2 decimal places.
422	ERROR	Please provide a valid transferId.	Enter a valid transfer ID.
422	ERROR	Invalid IFSC code provided for bank account.	Enter a valid IFSC.
422	ERROR	Invalid bank account number or IFSC provided.	Enter a valid bank account number and IFSC.

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).

paymentInstrumentId

string

Specify the fund source ID from where you want the amount to be debited.

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

Was this page helpful?

Get Batch Transfer Status V1.2 Batch Transfer V1.2

{
  "status": "ACCEPTED",
  "subCode": "201",
  "message": "Transfer Initiated",
  "data": {
    "referenceId": "107260"
  }
}

Payout APIs

V2

V1

One Escrow

Cashgram

Standard Transfer Async v1.2

Headers

Body

Response