Batch Transfer V2

Use this API to initiate a batch transfer request at Cashfree Payments. You can transfer money to multiple beneficiaries. The batch transfer limit is 5,000 in the production environment and 1,000 by default in the test environment.

POST /transfers/batch

Batch Transfer V2

cURL

curl --request POST \
  --url https://sandbox.cashfree.com/payout/transfers/batch \
  --header 'Content-Type: application/json' \
  --header 'x-api-version: <x-api-version>' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --data '
{
  "batch_transfer_id": "test_batch_transfer_id",
  "transfers": [
    {
      "transfer_id": "JUNOB2018",
      "transfer_amount": 1,
      "beneficiary_details": {
        "beneficiary_id": "JOHN18011"
      }
    },
    {
      "transfer_id": "JUNOB2018",
      "transfer_amount": 1,
      "transfer_mode": "imps",
      "beneficiary_details": {
        "beneficiary_details": {
          "beneficiary_instrument_details": {
            "bank_account_number": "1234554321",
            "bank_ifsc": "SBIN0001161"
          }
        }
      }
    },
    {
      "transfer_id": "JUNOB2018",
      "transfer_amount": 1,
      "transfer_mode": "imps",
      "beneficiary_details": {
        "beneficiary_details": {
          "beneficiary_id": "JOHN18011"
        }
      },
      "fundsource_id": "CASHFREE_1"
    }
  ]
}
'

import requests

url = "https://sandbox.cashfree.com/payout/transfers/batch"

payload = {
    "batch_transfer_id": "test_batch_transfer_id",
    "transfers": [
        {
            "transfer_id": "JUNOB2018",
            "transfer_amount": 1,
            "beneficiary_details": { "beneficiary_id": "JOHN18011" }
        },
        {
            "transfer_id": "JUNOB2018",
            "transfer_amount": 1,
            "transfer_mode": "imps",
            "beneficiary_details": { "beneficiary_details": { "beneficiary_instrument_details": {
                        "bank_account_number": "1234554321",
                        "bank_ifsc": "SBIN0001161"
                    } } }
        },
        {
            "transfer_id": "JUNOB2018",
            "transfer_amount": 1,
            "transfer_mode": "imps",
            "beneficiary_details": { "beneficiary_details": { "beneficiary_id": "JOHN18011" } },
            "fundsource_id": "CASHFREE_1"
        }
    ]
}
headers = {
    "x-api-version": "<x-api-version>",
    "x-client-id": "<api-key>",
    "x-client-secret": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-api-version': '<x-api-version>',
    'x-client-id': '<api-key>',
    'x-client-secret': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    batch_transfer_id: 'test_batch_transfer_id',
    transfers: [
      {
        transfer_id: 'JUNOB2018',
        transfer_amount: 1,
        beneficiary_details: {beneficiary_id: 'JOHN18011'}
      },
      {
        transfer_id: 'JUNOB2018',
        transfer_amount: 1,
        transfer_mode: 'imps',
        beneficiary_details: {
          beneficiary_details: {
            beneficiary_instrument_details: {bank_account_number: '1234554321', bank_ifsc: 'SBIN0001161'}
          }
        }
      },
      {
        transfer_id: 'JUNOB2018',
        transfer_amount: 1,
        transfer_mode: 'imps',
        beneficiary_details: {beneficiary_details: {beneficiary_id: 'JOHN18011'}},
        fundsource_id: 'CASHFREE_1'
      }
    ]
  })
};

fetch('https://sandbox.cashfree.com/payout/transfers/batch', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://sandbox.cashfree.com/payout/transfers/batch",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'batch_transfer_id' => 'test_batch_transfer_id',
    'transfers' => [
        [
                'transfer_id' => 'JUNOB2018',
                'transfer_amount' => 1,
                'beneficiary_details' => [
                                'beneficiary_id' => 'JOHN18011'
                ]
        ],
        [
                'transfer_id' => 'JUNOB2018',
                'transfer_amount' => 1,
                'transfer_mode' => 'imps',
                'beneficiary_details' => [
                                'beneficiary_details' => [
                                                                'beneficiary_instrument_details' => [
                                                                                                                                'bank_account_number' => '1234554321',
                                                                                                                                'bank_ifsc' => 'SBIN0001161'
                                                                ]
                                ]
                ]
        ],
        [
                'transfer_id' => 'JUNOB2018',
                'transfer_amount' => 1,
                'transfer_mode' => 'imps',
                'beneficiary_details' => [
                                'beneficiary_details' => [
                                                                'beneficiary_id' => 'JOHN18011'
                                ]
                ],
                'fundsource_id' => 'CASHFREE_1'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-version: <x-api-version>",
    "x-client-id: <api-key>",
    "x-client-secret: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://sandbox.cashfree.com/payout/transfers/batch"

	payload := strings.NewReader("{\n  \"batch_transfer_id\": \"test_batch_transfer_id\",\n  \"transfers\": [\n    {\n      \"transfer_id\": \"JUNOB2018\",\n      \"transfer_amount\": 1,\n      \"beneficiary_details\": {\n        \"beneficiary_id\": \"JOHN18011\"\n      }\n    },\n    {\n      \"transfer_id\": \"JUNOB2018\",\n      \"transfer_amount\": 1,\n      \"transfer_mode\": \"imps\",\n      \"beneficiary_details\": {\n        \"beneficiary_details\": {\n          \"beneficiary_instrument_details\": {\n            \"bank_account_number\": \"1234554321\",\n            \"bank_ifsc\": \"SBIN0001161\"\n          }\n        }\n      }\n    },\n    {\n      \"transfer_id\": \"JUNOB2018\",\n      \"transfer_amount\": 1,\n      \"transfer_mode\": \"imps\",\n      \"beneficiary_details\": {\n        \"beneficiary_details\": {\n          \"beneficiary_id\": \"JOHN18011\"\n        }\n      },\n      \"fundsource_id\": \"CASHFREE_1\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-version", "<x-api-version>")
	req.Header.Add("x-client-id", "<api-key>")
	req.Header.Add("x-client-secret", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://sandbox.cashfree.com/payout/transfers/batch")
  .header("x-api-version", "<x-api-version>")
  .header("x-client-id", "<api-key>")
  .header("x-client-secret", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"batch_transfer_id\": \"test_batch_transfer_id\",\n  \"transfers\": [\n    {\n      \"transfer_id\": \"JUNOB2018\",\n      \"transfer_amount\": 1,\n      \"beneficiary_details\": {\n        \"beneficiary_id\": \"JOHN18011\"\n      }\n    },\n    {\n      \"transfer_id\": \"JUNOB2018\",\n      \"transfer_amount\": 1,\n      \"transfer_mode\": \"imps\",\n      \"beneficiary_details\": {\n        \"beneficiary_details\": {\n          \"beneficiary_instrument_details\": {\n            \"bank_account_number\": \"1234554321\",\n            \"bank_ifsc\": \"SBIN0001161\"\n          }\n        }\n      }\n    },\n    {\n      \"transfer_id\": \"JUNOB2018\",\n      \"transfer_amount\": 1,\n      \"transfer_mode\": \"imps\",\n      \"beneficiary_details\": {\n        \"beneficiary_details\": {\n          \"beneficiary_id\": \"JOHN18011\"\n        }\n      },\n      \"fundsource_id\": \"CASHFREE_1\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://sandbox.cashfree.com/payout/transfers/batch")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-version"] = '<x-api-version>'
request["x-client-id"] = '<api-key>'
request["x-client-secret"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"batch_transfer_id\": \"test_batch_transfer_id\",\n  \"transfers\": [\n    {\n      \"transfer_id\": \"JUNOB2018\",\n      \"transfer_amount\": 1,\n      \"beneficiary_details\": {\n        \"beneficiary_id\": \"JOHN18011\"\n      }\n    },\n    {\n      \"transfer_id\": \"JUNOB2018\",\n      \"transfer_amount\": 1,\n      \"transfer_mode\": \"imps\",\n      \"beneficiary_details\": {\n        \"beneficiary_details\": {\n          \"beneficiary_instrument_details\": {\n            \"bank_account_number\": \"1234554321\",\n            \"bank_ifsc\": \"SBIN0001161\"\n          }\n        }\n      }\n    },\n    {\n      \"transfer_id\": \"JUNOB2018\",\n      \"transfer_amount\": 1,\n      \"transfer_mode\": \"imps\",\n      \"beneficiary_details\": {\n        \"beneficiary_details\": {\n          \"beneficiary_id\": \"JOHN18011\"\n        }\n      },\n      \"fundsource_id\": \"CASHFREE_1\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

200

batch_transfer_received_response_v2

{
  "batch_transfer_id": "test_batch_transfer_id",
  "cf_batch_transfer_id": "123456",
  "status": "RECEIVED"
}

5XX error
When you get a 5XX response, don’t initiate another transaction.
Check the status of the batch transfer using Get Batch Transfer Status V2 and then proceed further.

Get Transfer Status
Use the Get Batch Transfer Status V2 API to get the status of the batch transfer request. The Get Transfer Status V2 API does not give you the status of the batch transfer requests.

Click to view the response codes.

HTTP status code	Status	Status code	Status description	Next action	Try again via Cashfree - Yes or no
200	APPROVAL_PENDING	VELOCITY_CHECK_FAILED	The transfer requires an approval as the count of transfers to a particular beneficiary etc, have breached the limit. You can approve or reject the transfer request from the Merchant Dashboard.	You can approve/reject the transfer on the Merchant Dashboard and go to Transfers > Approve tab. Post the transfer is approved, the request is sent to the partner bank for further processing.	-
200	APPROVAL_PENDING	TRANSFER_LIMIT_BREACH	The transfer requires approval as the transfer amount etc, has breached the limit. You can approve or reject the transfer request from the Merchant Dashboard.	You can approve/reject the transfer on the Merchant Dashboard and go to Transfers > Approve tab. Post the transfer is approved, the request is sent to the partner bank for further processing.	-
200	APPROVAL_PENDING	APPROVAL_PENDING	The transfer requires approval. You can approve or reject the transfer request from the Merchant Dashboard.	You can approve/reject the transfer on the Merchant Dashboard and go to Transfers > Approve tab. Post the transfer is approved, the request is sent to the partner bank for further processing.	-
200	APPROVAL_PENDING	ANOMALY_DETECTION	The transfer requires approval as it is a high risk transaction detected by the Payout Protect model. You can approve or reject the transfer request from the Merchant Dashboard and go to Payout Protect > Risky Transfers > Flagged Transfers	You can approve/reject the transfer on the Merchant Dashboard and go to Payout Protect > Risky Transfers > Flagged Transfers tab. Post the transfer is approved, the request is sent to the partner bank for further processing.	-
200	APPROVAL_PENDING	RISK_CHECK_MANUAL_REVIEW_REQ	The transfer requires approval as it has been flagged by the Payout Protect risk model for manual review. You can approve or reject the transfer request from the Merchant Dashboard.	Approve/reject the transfer on the Merchant Dashboard and go to Payout Protect > Risky Transfers > Flagged Transfers tab.	-
200	APPROVAL_PENDING	RISK_CHECK_ANOMALY_DETECTED	The transfer requires approval as it has been flagged by the Payout Protect risk model for manual review due to anomaly detection. You can approve or reject the transfer request from the Merchant Dashboard.	Approve/reject the transfer on the Merchant Dashboard and go to Payout Protect > Risky Transfers > Flagged Transfers tab.	-
200	APPROVAL_PENDING	RISK_CHECK_BENEFICIARY_HIGH_RISK	The transfer requires approval as the beneficiary has been identified as high risk by the Payout Protect model. You can approve or reject the transfer request from the Merchant Dashboard.	Approve/reject the transfer on the Merchant Dashboard and go to Payout Protect > Risky Transfers > Flagged Transfers tab.	-
200	APPROVAL_PENDING	RISK_CHECK_VELOCITY_THRESHOLD	The transfer requires approval as it breaches the velocity threshold set in the Payout Protect rules. You can approve or reject the transfer request from the Merchant Dashboard.	Approve/reject the transfer on the Merchant Dashboard and go to Payout Protect > Risky Transfers > Flagged Transfers tab.	-
200	APPROVAL_PENDING	RISK_CHECK_TIME_WINDOW_BREACH	The transfer requires approval as it falls outside the allowed time window defined in the Payout Protect rules. You can approve or reject the transfer request from the Merchant Dashboard.	Approve/reject the transfer on the Merchant Dashboard and go to Payout Protect > Risky Transfers > Flagged Transfers tab.	-
200	APPROVAL_PENDING	RISK_CHECK_AMOUNT_THRESHOLD	The transfer requires approval as it exceeds the amount threshold set in the Payout Protect rules. You can approve or reject the transfer request from the Merchant Dashboard.	Approve/reject the transfer on the Merchant Dashboard and go to Payout Protect > Risky Transfers > Flagged Transfers tab.	-
200	APPROVAL_PENDING	HIGH_RISK_BENEFICIARY	The transfer requires approval as the beneficiary is identified as high risk. You can approve or reject the transfer request from the Merchant Dashboard.	Approve/reject the transfer on the Merchant Dashboard and go to Payout Protect > Risky Transfers > Flagged Transfers tab.	-
200	APPROVAL_PENDING	UNUSUAL_ACTIVITY_DETECTED	The transfer requires approval as unusual activity has been detected in the transfer pattern. You can approve or reject the transfer request from the Merchant Dashboard.	Approve/reject the transfer on the Merchant Dashboard and go to Payout Protect > Risky Transfers > Flagged Transfers tab.	-
200	APPROVAL_PENDING	BLACKOUT_WINDOW_RULE	The transfer requires approval as it falls within the blackout window defined in the Payout Protect rules. You can approve or reject the transfer request from the Merchant Dashboard.	Approve/reject the transfer on the Merchant Dashboard and go to Payout Protect > Risky Transfers > Flagged Transfers tab.	-
200	APPROVAL_PENDING	CUSTOM_RULE_TRIGGERED	The transfer requires approval as it has triggered a custom rule defined in the Payout Protect settings. You can approve or reject the transfer request from the Merchant Dashboard.	Approve/reject the transfer on the Merchant Dashboard and go to Payout Protect > Risky Transfers > Flagged Transfers tab.	-
200	APPROVAL_PENDING	MANUAL_APPROVAL_REQUIRED	The transfer requires manual approval as per the configured workflow. You can approve or reject the transfer request from the Merchant Dashboard.	Approve/reject the transfer on the Merchant Dashboard and go to Transfers > Approve tab.	-
200	APPROVAL_PENDING	COMPLIANCE_REVIEW_PENDING	The transfer requires approval as it is pending compliance review. You can approve or reject the transfer request from the Merchant Dashboard.	Approve/reject the transfer on the Merchant Dashboard and go to Transfers > Approve tab.	-
200	FAILED	WAIT_TIME_EXCEEDED	The transfer has failed because there was an intermittent internal error at Cashfree. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes
200	FAILED	BENE_BANK_DECLINED	The transfer has failed because the beneficiary bank has declined the transfer. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again with the partner bank(s).	-	Yes
200	FAILED	IMPS_MODE_FAIL	The transfer has failed because the beneficiary account does not support IMPS transfers. This rejection is done by the partner bank for the specific beneficiary account. You can try NEFT or other channels to do the disbursals	You can try NEFT or other channels to do the disbursals.	Yes, via a different mode
200	FAILED	SOURCE_BANK_DECLINED	The transfer has failed because our partner bank has declined the transfer because of their internal checks, technical declines etc. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again with the partner bank(s).	You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again with other partner bank(s).	Yes
200	FAILED	CONNECTION_TIMEOUT	The transfer has failed because there was a connection timeout between the bank and Cashfree. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again with the partner bank(s).	You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again with the partner bank(s).	Yes
200	FAILED	PAYOUT_INTERNAL_ERROR	The transfer has failed because there was an intermittent internal error at Cashfree. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	-	Yes
200	FAILED	NPCI_UNAVAILABLE	The transfer has failed because NPCI was unavailable to complete the transfer request. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree. The success of the request is contingent on NPCI services being up.	-	Yes, after some time
200	FAILED	DEST_LIMIT_REACHED	The transfer has failed because the beneficiary account has breached the limit of receiving funds. This rejection is done by the beneficiary bank for the specific beneficiary account. You can reinitiate the transfer after a while via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s). The success of the request is contingent on beneficiary’s limit being available to receive incoming funds.	-	Yes, after some time
200	FAILED	RETURNED_FROM_BENEFICIARY	The transfer has failed because the beneficiary bank has returned the transfer and has not need able to credit funds to the end beneficiary. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again with the partner bank(s).	-	-
200	FAILED	PAYOUT_INTERNAL_ERROR	The transfer has failed because there was an intermittent internal error at Cashfree. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	-	-
200	FAILED	INVALID_BENE_ACCOUNT_OR_IFSC	The transfer has failed because the beneficiary account or IFSC is invalid. After correcting the beneficiary account or IFSC, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	-	-
200	FAILED	PAYOUT_INTERNAL_ERROR	The transfer has failed because there was an intermittent internal error at Cashfree. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	-	-
200	FAILED	FAILED	The transfer has failed because there was an intermittent issue at the partner bank’s end. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes, after some time
200	FAILED	PAYOUT_INTERNAL_ERROR	The transfer has failed because there was an intermittent internal error at Cashfree. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	-	-
200	FAILED	INSUFFICIENT_BALANCE	The transfer has failed because of low balance in your Cashfree Wallet/ Bank Account. After recharging the account, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	After recharging the account, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes, after recharging
200	FAILED	INVALID_BENE_VPA	The transfer has failed because the beneficiary VPA is invalid. After correcting the VPA handle, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	After correcting the VPA handle, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes, after correcting the VPA handle
200	FAILED	INVALID_IFSC_FAIL	The transfer has failed because the IFSC is invalid. After correcting the IFSC, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	After correcting the IFSC, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes, after correcting the IFSC
200	FAILED	BAD_GATEWAY	The transfer has failed because there was an intermittent internal error at Cashfree. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes
200	FAILED	INVALID_AMOUNT_FAIL	The transfer has failed because the amount entered is invalid. After correcting the amount, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	After correcting the amount, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes, after correcting the amount
200	FAILED	INVALID_ACCOUNT_FAIL	The transfer has failed because the Account Number of the beneficiary is invalid, as per our partner bank. After correcting the account number, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	After correcting the account number, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes, after correcting the account number
200	FAILED	INVALID_REQUEST	The transfer has failed because the transfer request is invalid, as per our partner bank, because of exceeding the character limit of certain parameter, wrong input etc. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	-	-
200	FAILED	ACCOUNT_BLOCKED	The transfer has failed because the account is blocked, as per our partner bank. After getting the account unblocked, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	After getting the account unblocked, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes, after unblocking the account number
200	FAILED	DEBIT_FAILURE	The transfer has failed because there was an intermittent internal error at Cashfree. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes
200	FAILED	BENEFICIARY_BANK_OFFLINE	The transfer has failed because the respective beneficiary bank is offline. After some time, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	After some time, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes
200	FAILED	AUTHENTICATION_FAILURE	The transfer has failed because there was an authentication failure at the partner bank’s end. After checking with the partner bank, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	This is a scenario when the API access is not working at the partner bank’s end. After checking with the partner bank, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes
200	FAILED	NRE_ACCOUNT_FAIL	The transfer has failed because the beneficiary account is an NRE Account and transfers to NRE Accounts are not supported, as per our partner bank.	Get a new account(non-NRE account) from the beneficiary; you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	No
200	FAILED	SOURCE_LIMIT_REACHED	The transfer has been failed by the partner bank as the source bank account has reached a limit of transferring funds. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	If you are on Cashfree Wallet, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s). If you are on Connected Bank, you need to recharge your bank account and then reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes, after some time
200	FAILED	BANK_GATEWAY_ERROR	The transfer has failed because there was an intermittent issue at the partner bank’s end. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes
200	FAILED	BAD_REQUEST	The transfer has failed because the details of the transfer request is invalid, as per our partner bank. After correcting the details in the transfer request, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	After correcting the details in the transfer request, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes
200	FAILED	REINITIALIZE_TRANSFER_LATER	The transfer has failed because there was an intermittent internal error at Cashfree. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes
200	MANUALLY_REJECTED	MANUALLY_REJECTED	The transfer has failed because it has been manually rejected by the merchant or any team member user who has the permissions to do the same on Merchant Dashboard. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again with the partner bank(s).	If the merchant wants to reinitiate the transfer, they can reinitiate the transfer via Cashfree so that the transfer can be reattempted again with the partner bank(s).	Yes, if you want to reinitiate the transfer
200	PENDING	SENT_TO_BANK	The transfer is currently in a Pending state, as Cashfree is awaiting a final confirmation from the partner bank for a terminal status. This has been sent to the bank by our banking operations team. Please do check statuses or await webhooks to know the terminal state of the transfer request.	Rely on Check Status API or webhooks	-
200	PENDING	BANK_GATEWAY_ERROR	The transfer is currently in a Pending state, as Cashfree is awaiting a final confirmation from the partner bank for a terminal status. You should rely only on Check Status API response or Webhooks to know the terminal state of the transfer request.	Rely on Check Status API or webhooks	-
200	PENDING	NO_SUCH_REQUEST	The transfer is currently in a Pending state, as Cashfree is awaiting a final confirmation from the partner bank for a terminal status. The bank is not able to find the request at their end as of now, and it has been sent to the bank by our banking operations team. Please do check statuses or await webhooks to know the terminal state of the transfer request.	Rely on Check Status API or webhooks	-
200	PENDING	IN_PROCESS	The transfer is currently in a Pending state, as Cashfree is awaiting a final confirmation from the partner bank for a terminal status. Please do check statuses or await webhooks to know the terminal state of the transfer request.	Rely on Check Status API or webhooks	-
200	PENDING	ERROR_FETCHING_STATUS	The transfer is currently in a Pending state, as Cashfree is awaiting a final confirmation from the partner bank for a terminal status. The response received from the partner bank has a new code. This has been raised with the bank to understand the new code. Please do check statuses or await webhooks to know the terminal state of the transfer request.	Rely on Check Status API or webhooks	-
200	PENDING	TRANSACTION_PROCESSED	The transfer is currently in a Pending state, as Cashfree is awaiting a final confirmation from the partner bank for a terminal status. You should rely only on Check Status API response or Webhooks to know the terminal state of the transfer request.	Rely on Check Status API or webhooks	-
200	PENDING	REQUEST_TIMEDOUT	The transfer is currently in a Pending state, as Cashfree is awaiting a final confirmation from the partner bank for a terminal status. The bank is not able to find the request at their end as of now as the request between the partner bank has probably timed out, and it has been highlighted to the bank by our banking operations team. Please do check statuses or await webhooks to know the terminal state of the transfer request.	Rely on Check Status API or webhooks	-
200	PENDING	DUPLICATE	The transfer is currently in a Pending state, as Cashfree is awaiting a final confirmation from the partner bank for a terminal status. The bank claims of receiving a duplicate request at their end as of now. You should rely only on Check Status API response or Webhooks to know the terminal state of the transfer request.	Rely on Check Status API or webhooks	-
200	PENDING	PENDING	The transfer is currently in a Pending state, as Cashfree is awaiting a final confirmation from the partner bank for a terminal status. You should rely only on Check Status API response or Webhooks to know the terminal state of the transfer request.
200	PENDING	SCHEDULED_FOR_NEXT_WORKINGDAY	The transfer is currently in a Pending state, as the bank has scheduled the transfer for the next working day. This typically happens for NEFT/RTGS transfers if they are initiated beyond the cut-off hours or during bank holidays. You should rely only on Check Status API response or Webhooks to know the terminal state of the transfer request.	-	-
200	PENDING	SUSPECT	The transfer is currently in a Pending state, as the bank has scheduled the transfer for the next working day. This typically happens for NEFT/RTGS transfers if they are initiated beyond the cut-off hours or during bank holidays. You should rely only on Check Status API response or Webhooks to know the terminal state of the transfer request.	-	-
200	PENDING	IMPLEMENTATION_ERROR	The transfer is currently in a Pending state, as Cashfree is awaiting a final confirmation from the partner bank for a terminal status. You should rely only on Check Status API response or Webhooks to know the terminal state of the transfer request.	-	-
200	PENDING	UNKNOWN_ERROR_CODE	The transfer is currently in a Pending state, as Cashfree is awaiting a final confirmation from the partner bank for a terminal status. The response received from the partner bank has a new code. This has been raised with the bank to understand the new code. Please do check statuses or await webhooks to know the terminal state of the transfer request.	-	-
200	QUEUED	QUEUED	The transfer is currently in a Pending state, as Cashfree is awaiting a final confirmation from the partner bank for a terminal status. You should rely only on Check Status API response or Webhooks to know the terminal state of the transfer request.	Rely on Check Status API or webhooks	-
200	RECEIVED	RECEIVED	The transfer has been received by Cashfree successfully for further processing. You should use Check Status API response or Webhooks to know the terminal state of the transfer request.	Rely on Check Status API or webhooks	-
200	REJECTED	BENE_NOT_EXIST	The transfer has been rejected because the beneficiary, added in the transfer request, does not exist. After adding the right beneficiary, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	After adding the right beneficiary, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes, after adding the right beneficiary
200	REJECTED	INSUFFICIENT_BALANCE	The transfer has been rejected because of low balance in your Cashfree Wallet. After recharging the account, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	After recharging the account, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes, after recharging
200	REJECTED	INSIDE_BLACKOUT_WINDOW	The transfer has been rejected because the transfer falls under the blackout window defined by you in Payout Protect. You can reinitiate the transfer via Cashfree, after the blackout window or after modifying the blackout window from the Merchant Dashboard, so that the transfer can be reattempted again by Cashfree with the partner bank(s).	You can reinitiate the transfer via Cashfree, after the blackout window or after modifying the blackout window from the Merchant Dashboard, so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes
200	REJECTED	INVALID_MODE_FOR_PYID	The transfer has been rejected because the payment instrument does not support this mode of transfer. You should get this mode activated on the payment instrument ID by contacting Cashfree, and then initiate a new transfer request.	You should get this mode activated on the payment instrument ID by contacting Cashfree, and then initiate a new transfer request.	Yes, after activating the mode.
200	REJECTED	BENE_BLACKLISTED	The transfer has been rejected because the beneficiary’s bank account and/or VPA handles have been blacklisted by Risk team. You should get a different bank account and/or VPA to send the transfer, or you can connect with Cashfree Team to understand more about this.	You should get a different bank account and/or VPA to send the transfer, or you can connect with Cashfree Team to understand more about this.	Yes, after correcting the beneficiary details
200	REJECTED	TRANSFER_NOT_ATTEMPTED	The transfer has failed because there was an intermittent internal error at Cashfree. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes
200	REJECTED	INVALID_TRANSFER_AMOUNT	The transfer has been rejected because the amount entered is invalid. After correcting the amount, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	After correcting the amount, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s)	Yes, after correcting the amount
200	REJECTED	TRANSFER_LIMIT_BREACH	The transfer has been rejected because the amount entered breaches the limits set for your payout account. After correcting the amount, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s). You can connect with Cashfree if you are not sure about the transfer limits set for your payout account.	After correcting the amount, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s). You can connect with Cashfree if you are not sure about the transfer limits set for your payout account.	Yes, after adhering to the transfer limits
200	REJECTED	INVALID_PAYMENT_INSTRUMENT	The transfer has been rejected because the payment instrument (fundsource_id parameter in the API request) used for attempting the transfer is invalid. After correcting the payment instrument, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).	After correcting the payment instrument, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).	Yes, after correcting the payment instrument
200	REJECTED	PAYOUT_INTERNAL_ERROR	The transfer has been rejected because there was an intermittent internal error at Cashfree. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes
200	REJECTED	VELOCITY_CHECK_FAILED	The transfer has been rejected because the amount entered breaches the limits set for your payout account. After correcting the amount, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s). You can connect with Cashfree if you are not sure about the transfer limits set for your payout account.	After correcting the amount, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s). You can connect with Cashfree if you are not sure about the transfer limits set for your payout account.	Yes, after adhering to the transfer limit
200	REJECTED	PAYOUT_INTERNAL_ERROR	The transfer has been rejected because there was an intermittent internal error at Cashfree. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes
200	REJECTED	PAYOUT_INTERNAL_ERROR	The transfer has been rejected because there was an intermittent internal error at Cashfree. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes
200	REJECTED	DISABLED_MODE	The transfer has been rejected because your payout account does not support this mode of transfer. You should get this mode activated on your payout account by contacting Cashfree, and then initiate a new transfer request.	You should get this mode activated on your payout account by contacting Cashfree, and then initiate a new transfer request.	Yes, after activating the mode
200	REJECTED	BANK_ACCOUNT_INVALID	The transfer has been rejected because there is a mismatch in the Bank Account Number of the beneficiary ID and the Bank Account Number in the transfer request. After correcting the Bank Account Number, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).	After correcting the Bank Account Number, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).	Yes, after correcting the bank account number
200	REJECTED	BANK_IFSC_INVALID	The transfer has been rejected because there is a mismatch in the IFSC of the beneficiary ID and the IFSC in the transfer request. After correcting the IFSC, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).	After correcting the IFSC, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).	Yes, after correcting the IFSC
200	REJECTED	VPA_INVALID	The transfer has been rejected because there is a mismatch in the VPA handle of the beneficiary ID and the VPA handle in the transfer request. After correcting the VPA handle, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).	After correcting the VPA handle, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).	Yes, after correcting the VPA handle
200	REJECTED	PHONE_INVALID	The transfer has been rejected because there is a mismatch in the Phone Number of the beneficiary ID and the Phone Number in the transfer request. After correcting the Phone Number, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).	After correcting the Phone Number, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).	Yes, after correcting the phone number.
200	REJECTED	BANK_ACCOUNT_DETAILS_MISSING	The transfer has been rejected because the Bank Account Details are missing in the transfer request. After adding the Bank Account Details, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).	After adding the Bank Account Details, you can reinitiate the transfer via Cashfree so that the transfer can be attempted by Cashfree with the partner bank(s).	Yes, after adding the bank account details.
200	REVERSED	ACCOUNT_BLOCKED	The transfer has been reversed by the beneficiary bank as the end-beneficiary’s account is blocked for receiving incoming funds. After correcting the account number or getting the account unblocked, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	After correcting the account number or getting the account unblocked, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes, after adding the new details or getting the account unblocked
200	REVERSED	FAILED	The transfer has been reversed by the beneficiary bank as they were unable to credit the end beneficiary’s bank account. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	-	Yes
200	REVERSED	NRE_ACCOUNT_FAIL	The transfer has been reversed by the beneficiary bank as they were unable to credit the end beneficiary’s bank account as it is an NRE Account and transfers to NRE Accounts are not supported.	Get a new account(non-NRE account) from the beneficiary; you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	No
200	REVERSED	RETURNED_FROM_BENEFICIARY	The transfer has been reversed by the beneficiary bank as they were unable to credit the end beneficiary’s bank account. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes
200	REVERSED	BENE_BANK_DECLINED	The transfer has been declined by the beneficiary bank and they were unable to credit the end beneficiary’s bank account. You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	You can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes
200	REVERSED	IMPS_MODE_FAIL	The transfer has been reversed by the beneficiary bank because the beneficiary bank account does not support IMPS transfers. This rejection is done by the beneficiary bank for the specific beneficiary account. You can try NEFT or other channels to do the disbursals.	You can reinitiate the transfer via Cashfree by changing the mode so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes, after changing the mode
200	REVERSED	DEST_LIMIT_REACHED	The transfer has been reversed by the beneficiary bank as the end-beneficiary’s account has reached a limit of receiving incoming funds. This rejection is done by the beneficiary bank for the specific beneficiary account. You can reinitiate the transfer after a while via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s). The success of the request is contingent on beneficiary’s limit being available to receive incoming funds.	The limits on the beneficiary account are typically refreshed every 24 hours. Its not clear when the 24 hour window shall elpase so you can then reinitiate the transfer via Cashfree after some time so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes, after some time.
200	REVERSED	INVALID_ACCOUNT_FAIL	The transfer has been reversed by the beneficiary bank because the Account Number of the beneficiary is invalid. After correcting the account number, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	After correcting the account number, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes, after correcting the account number
200	REVERSED	BENE_NAME_DIFFERS	The transfer has been reversed by the beneficiary bank because the Account Name of the beneficiary is different. After correcting the beneficiary name, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	After correcting the beneficiary name, you can reinitiate the transfer via Cashfree so that the transfer can be reattempted again by Cashfree with the partner bank(s).	Yes, after correcting the account name
200	SUCCESS	SENT_TO_BENEFICIARY	The transfer has been initiated via the partner bank successfully. The request is waiting to be processed at the beneficiary bank to do the credit to the end beneficiary.	-	-
200	SUCCESS	COMPLETED	The transfer has been initiated via the partner bank successfully, hence your account is debited and the request is successfully processed by the beneficiary bank and has been credited to the end beneficiary.	-	-

4XX errors

HTTP status code	Error code	Message	Next action
400	batch_transfer_id_missing	batch_transfer_id_missing is missing in the request	Enter a batch transfer ID in the request.
400	batch_transfer_id_invalid	batch_transfer_id_invalid should be alphanumeric	Enter a valid batch transfer ID.
400	transfers[0].transfer_id_invalid	transfer_id should be alphanumeric	Enter a valid transfer ID.
400	transfers[0].transfer_id_missing	transfer_id is missing in the request	Enter a transfer ID in the request.
400	transfers[0].transfer_amount_invalid	transfer_amount should be greater then 1.00	Enter an amount greater than 1.00.
400	transfers[0].transfer_amount_missing	transfer_amount is missing in the request	Enter a transfer amount in the request.
400	transfers[0].transfer_mode_invalid	transfer_mode is invalid allowed values are : bank, imps, neft, rtgs, upi, paytm, amazonpay, card and cardupi	Enter a valid transfer mode.
400	transfers[0].beneficiary_details.beneficiary_id_invalid	beneficiary_id should be alphanumeric	Enter a valid beneficiary ID.
400	transfers[0].beneficiary_details.beneficiary_name_invalid	beneficiary_name is invalid. only alphabets and whitespaces are allowed	Enter a valid beneficiary name.
400	transfers[0].beneficiary_details.beneficiary_instrument_details.bank_account_number_invalid	bank_account_number should be alphanumeric	Enter a valid bank account number.
400	transfers[0].beneficiary_details.beneficiary_instrument_details.bank_ifsc_invalid	bank_ifsc should be in standard ifsc format	Enter a valid IFSC.
400	transfers[0].beneficiary_details.beneficiary_instrument_details.vpa_invalid	vpa is in invalid format	Enter a valid VPA.

Authorizations

x-client-id · string · header · required

Client app ID. You can find your app ID in the Merchant Dashboard.

x-client-secret · string · header · required

Client secret key. You can find your secret key in the [Merchant Dashboard]((https://merchant.cashfree.com/payouts/developers/api-keys).

Headers

x-api-version · string · default: 2024-01-01 · required

It is the API version to be used.

x-request-id · string

Request ID for the API call. Can be used to resolve tech issues. Communicate this in your tech related queries to Cashfree.

x-cf-signature · string

Signature to be sent if IP is not whitelisted.

Body

application/json

Find the request parameters of the API request to transfer money to multiple beneficiaries.

Batch Transfer V2

batch_transfer_id · string · required

It is the unique ID you create to identify the batch transfer request. The maximum character limit is 60. Alphanumeric and underscore ( _ ) characters are allowed.

Maximum string length: 60

transfers · object[]

Show child attributes

Response

200

application/json

OK

Batch Transfer V2 Response

batch_transfer_id · string

It displays the unique ID you created to identify the batch transfer request.

cf_batch_transfer_id · string

It displays the unique ID created by Cashfree Payments. You receive this ID in the response after initiating the batch transfer request.

status · string

It displays the status of the API request.