Skip to main content
POST
/
payout
/
v1
/
lend
Lend
curl --request POST \
  --url https://payout-api.cashfree.com/payout/v1/lend \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '{
  "beneId": "<string>",
  "loanId": "<string>",
  "amount": "<string>",
  "transferMode": "<string>",
  "serviceCharges": "[{\"key\":\"\", \"value\":\"\"}]",
  "beneDetails": {
    "bankAccount": "<string>",
    "ifsc": "<string>",
    "name": "<string>",
    "phone": "<string>",
    "email": "<string>",
    "vpa": "<string>",
    "address1": "<string>"
  }
}'
"{\n  \"status\":\"SUCCESS\",\n  \"subCode\":\"200\",\n  \"message\":\"Transfer completed successfully\",\n  \"data\":\n      { \n        \"referenceId\":\"54109311\",\n        \"utr\":\"1681409852019854\",\n        \"acknowledged\": 1\n      }\n}\n"
Please use this Authorization token in headers to call any payout API (Refresh this page if the token is expired)
Sub CodeStatusMessageNext Action
200SUCCESSTransfer completed successfullyNone
201PENDINGTransfer request pending at the bankNone
400ERRORbeneId is missing in the requestEnter a beneId in the request
400ERRORTotal service charge is greater than disbursal amountEnter valid amount which is greater than sum of service charges
400ERRORInsufficient balance in LENDER fundsourceLender needs to recharges their CF wallet
403ERRORAPIs not enabled. Please fill out the Support FormPlease fill out the Support Form
422ERRORPlease provide valid token detailsProvide a valid token
422ERRORamount should be at least 1.0Enter a transfer amount that is equal to or more than Rs. 1.
422ERRORInvalid bank account number or ifsc providedProvide valid bank account details

Headers

ā€‹
Authorization
string
required

Bearer Auth Token

ā€‹
Content-Type
string
required

application/json

Body

application/json
ā€‹
beneId
string
required

It is the unique ID to identify the beneficiary. Only alphanumeric characters are allowed.

ā€‹
loanId
string
required

It is the unique ID to identify the loan. Only alphanumeric characters are allowed.

ā€‹
amount
string
required

It is the loan amount. It should be equal to or greater than 1.00.

ā€‹
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.

ā€‹
serviceCharges
string
default:[{"key":"", "value":""}]

It is the service charges that need to be disbursed to different parties.

ā€‹
beneDetails
object

It is the details of the beneficiary.

Response

200

  • Success transfer for beneId
  • Success transfer for beneDetails bank account
  • Sucess transfer for beneDetails VPA
ā€‹
status
string
Example:

"SUCCESS"

ā€‹
subCode
string
Example:

"200"

ā€‹
message
string
Example:

"Transfer completed successfully"

ā€‹
data
object