Internal Transfer

Use this API to request an internal transfer at Cashfree. The internal transfer API is useful for multiple Payouts accounts. The API response will either result in an ERROR or SUCCESS response.

POST /payout/v1/internalTransfer

Internal Transfer

cURL

curl --request POST \
  --url https://payout-api.cashfree.com/payout/v1/internalTransfer \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "amount": 123,
  "rechargeAccount": "<string>",
  "transferId": "<string>"
}
'

import requests

url = "https://payout-api.cashfree.com/payout/v1/internalTransfer"

payload = {
    "amount": 123,
    "rechargeAccount": "<string>",
    "transferId": "<string>"
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "<content-type>"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<authorization>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({amount: 123, rechargeAccount: '<string>', transferId: '<string>'})
};

fetch('https://payout-api.cashfree.com/payout/v1/internalTransfer', 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://payout-api.cashfree.com/payout/v1/internalTransfer",
  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([
    'amount' => 123,
    'rechargeAccount' => '<string>',
    'transferId' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: <content-type>"
  ],
]);

$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://payout-api.cashfree.com/payout/v1/internalTransfer"

	payload := strings.NewReader("{\n  \"amount\": 123,\n  \"rechargeAccount\": \"<string>\",\n  \"transferId\": \"<string>\"\n}")

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

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "<content-type>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://payout-api.cashfree.com/payout/v1/internalTransfer")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "<content-type>")
  .body("{\n  \"amount\": 123,\n  \"rechargeAccount\": \"<string>\",\n  \"transferId\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://payout-api.cashfree.com/payout/v1/internalTransfer")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = '<content-type>'
request.body = "{\n  \"amount\": 123,\n  \"rechargeAccount\": \"<string>\",\n  \"transferId\": \"<string>\"\n}"

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

200

{
  "status": "SUCCESS",
  "subCode": "200",
  "message": "RefId-a0302c78d13142b89d85af472961901528/006291823001146-Internal Fund Transfer",
  "data": {
    "transferId": "a0302c78d13142b89d85af472961901528"
  }
}

{
  "status": "ERROR",
  "subCode": "403",
  "message": "APIs not enabled. Please fill out the [Support Form](https://merchant.cashfree.com/merchants/landing?env=prod&raise_issue=1)"
}

{
  "status": "ERROR",
  "subCode": "404",
  "message": "Recharge Account not found"
}

{
  "status": "ERROR",
  "subCode": "422",
  "message": "Account not configured. Please reach out to accoount manager"
}

Please use this Authorization token in headers to call any payout API (Refresh this page if the token is expired)

Headers

Authorization · string · required

Bearer auth token

Content-Type · string · required

application/json

Body

application/json

amount · number<float> · required

Amount to be transferred. Number (>=1)

rechargeAccount · string · required

Cashfree internal recharge account number. Alphanumeric allowed

transferId · string

A unique ID to identify this transfer. Alphanumeric, hyphen and underscore (_) allowed (40 character limit). If the value is not passed, the id will be autogenerated.

Response

200

application/json

200

status · string

Example:

"SUCCESS"

subCode · string

Example:

"200"

message · string

Example:

"RefId-a0302c78d13142b89d85af472961901528/006291823001146-Internal Fund Transfer"

data · object

Show child attributes