v2025-01-01
- Overview
- Orders
- Payments
- Payment Links
- Refunds
- Customers
- Payment Methods
- Offers
- Settlements
- Simulation
- Utilities
Direct Transfer V1.2
Use this API to initiate amount transfers directly to the beneficiary account via a bank transfer or UPI. You can add the beneficiary details in the same API request.
POST
/
payout
/
v1.2
/
directTransfer
Copy
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": {
"bankAccount": "<string>",
"ifsc": "<string>",
"name": "<string>",
"phone": "<string>",
"email": "<string>",
"vpa": "<string>",
"address1": "<string>"
},
"paymentInstrumentId": "<string>"
}'
Copy
"// case 1 PENDING\n{\n \"status\": \"PENDING\",\n \"subCode\": \"201\",\n \"message\": \"Transfer request pending at the bank\",\n \"data\": {\n \"referenceId\": \"23457526\",\n \"utr\": \"\",\n \"acknowledged\": 0\n }\n}\n\n// Case 2 SUCCESS\n{\n \"status\":\"SUCCESS\", \n \"subCode\":\"200\", \n \"message\":\"Transfer completed successfully\", \n \"data\": \n {\n \"referenceId\":\"10023\",\n \"utr\":\"P16111765023806\",\n \"acknowledged\": 1\n }\n}\n\n// Case 3 ERROR\n\n{\n \"status\": \"ERROR\",\n \"subCode\": \"400\",\n \"message\": \"Transfer Id already exists\"\n}\n"
Copy
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": {
"bankAccount": "<string>",
"ifsc": "<string>",
"name": "<string>",
"phone": "<string>",
"email": "<string>",
"vpa": "<string>",
"address1": "<string>"
},
"paymentInstrumentId": "<string>"
}'
Copy
"// case 1 PENDING\n{\n \"status\": \"PENDING\",\n \"subCode\": \"201\",\n \"message\": \"Transfer request pending at the bank\",\n \"data\": {\n \"referenceId\": \"23457526\",\n \"utr\": \"\",\n \"acknowledged\": 0\n }\n}\n\n// Case 2 SUCCESS\n{\n \"status\":\"SUCCESS\", \n \"subCode\":\"200\", \n \"message\":\"Transfer completed successfully\", \n \"data\": \n {\n \"referenceId\":\"10023\",\n \"utr\":\"P16111765023806\",\n \"acknowledged\": 1\n }\n}\n\n// Case 3 ERROR\n\n{\n \"status\": \"ERROR\",\n \"subCode\": \"400\",\n \"message\": \"Transfer Id already exists\"\n}\n"
Assistant
Responses are generated using AI and may contain mistakes.