Skip to main content
POST
/
payout
/
v1.2
/
directTransfer
Direct Transfer V1.2
curl --request POST \
  --url https://payout-api.cashfree.com/payout/v1.2/directTransfer \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "amount": 123,
  "transferId": "<string>",
  "transferMode": "<string>",
  "beneDetails": {
    "name": "<string>",
    "phone": "<string>",
    "email": "<string>",
    "address1": "<string>",
    "bankAccount": "<string>",
    "ifsc": "<string>",
    "vpa": "<string>"
  },
  "paymentInstrumentId": "<string>"
}
'
{
  "status": "PENDING",
  "subCode": "201",
  "message": "Transfer request pending at the bank",
  "data": {
    "referenceId": "23457526",
    "utr": "",
    "acknowledged": 0
  }
}

Documentation Index

Fetch the complete documentation index at: https://www.cashfree.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
Authorization
string
required

Bearer auth token.

​
Content-Type
string
required

application/json

Body

application/json

Amount, transfer ID, transfer mode, and inline beneficiary details for a synchronous direct transfer (including Process Validated Payout when you pass the transfer token from Validate Payout).

​
amount
number<float>
required

Amount to be transferred. Amount should be greater that INR 1.00. Decimals are allowed.

​
transferId
string
required

A unique ID to identify this transfer. Alphanumeric characters and underscores are allowed (40 character limit).

​
transferMode
string
required

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

​
beneDetails
object
required

Object with the beneficiary details to whom amount is to be transferred

​
paymentInstrumentId
string

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

Response

200 - Transfer Status

​
status
string

High-level state of the transfer request (for example SUCCESS, PENDING, or ERROR).

Example:

"SUCCESS"

​
subCode
string

Numeric sub-code that qualifies the status value.

Example:

"200"

​
message
string
Example:

"Transfer completed successfully"

​
data
object

Partner-facing references for the accepted transfer, including the Cashfree reference ID, bank or network UTR when issued, and partner acknowledgement.