curl -X GET https://api.razorpay.com/v1/payments/pay_JGmCgTEa9OTQcX/transfers \
-u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
RazorpayClient razorpay = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");
String paymentId = "pay_JGmCgTEa9OTQcX";
List<Payment> payments = razorpay.payments.fetchAllTransfers(paymentId)
$api = new Api($key_id, $secret);
$api->payment->fetch('payment')->transfers();
var instance = new Razorpay({ key_id: 'YOUR_KEY_ID', key_secret: 'YOUR_SECRET' })
instance.payments.fetchTransfer(paymentId)
client = razorpay.Client(auth=("YOUR_ID", "YOUR_SECRET"))
client.payment.transfers(paymentId)
require "razorpay"
Razorpay.setup('YOUR_KEY_ID', 'YOUR_SECRET')
paymentId = "pay_JGmCgTEa9OTQcX"
Razorpay::Payment.fetch(paymentId).fetch_transfer
import ( razorpay "github.com/razorpay/razorpay-go" )
client := razorpay.NewClient("YOUR_KEY_ID", "YOUR_SECRET")
body, err := client.Payment.Transfers("<paymentId>", nil, nil)
RazorpayClient client = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]
");
string paymentId = "pay_E9up5WhIfMYnKW";
List<Transfer> token = client.Payment.Fetch(paymentId).Transfers();
razorpay route transfers fetch-by-payment pay_JMNiqyuoFoJcXb
{
"entity": "collection",
"count": 2,
"items": [
{
"id": "trf_JJD535tJtk6Yy0",
"entity": "transfer",
"status": "processed",
"source": "pay_JGmCgTEa9OTQcX",
"recipient": "acc_IROu8Nod6PXPtZ",
"amount": 100,
"currency": "INR",
"amount_reversed": 0,
"fees": 1,
"tax": 0,
"notes": {
"name": "Gaurav Kumar",
"roll_no": "IEC2011025"
},
"linked_account_notes": [
"roll_no"
],
"on_hold": true,
"on_hold_until": 1671222870,
"settlement_status": "on_hold",
"recipient_settlement_id": null,
"created_at": 1649933574,
"processed_at": 1649933579,
"error": {
"code": null,
"description": null,
"reason": null,
"field": null,
"step": null,
"id": "trf_JJD535tJtk6Yy0",
"source": null,
"metadata": null
}
},
{
"id": "trf_JJD536GI6wuz3m",
"entity": "transfer",
"status": "processed",
"source": "pay_JGmCgTEa9OTQcX",
"recipient": "acc_IRQWUleX4BqvYn",
"amount": 300,
"currency": "INR",
"amount_reversed": 0,
"fees": 1,
"tax": 0,
"notes": {
"name": "Saurav Kumar",
"roll_no": "IEC2011026"
},
"linked_account_notes": [
"roll_no"
],
"on_hold": false,
"on_hold_until": null,
"settlement_status": "pending",
"recipient_settlement_id": null,
"created_at": 1649933574,
"processed_at": 1649933579,
"error": {
"code": null,
"description": null,
"reason": null,
"field": null,
"step": null,
"id": "trf_JJD536GI6wuz3m",
"source": null,
"metadata": null
}
}
]
}
{
"error":{
"code":"BAD_REQUEST_ERROR",
"description":"The api key provided is invalid",
"source":"NA",
"step":"NA",
"reason":"NA",
"metadata":{
}
}
}
{
"entity": "collection",
"count": 2,
"items": [
{
"id": "trf_JJD535tJtk6Yy0",
"entity": "transfer",
"status": "processed",
"source": "pay_JGmCgTEa9OTQcX",
"recipient": "acc_IROu8Nod6PXPtZ",
"amount": 100,
"currency": "MYR",
"amount_reversed": 0,
"fees": 1,
"tax": 0,
"notes": {
"name": "Nur Aisyah",
"roll_no": "IEC2011025"
},
"linked_account_notes": [
"roll_no"
],
"on_hold": true,
"on_hold_until": 1671222870,
"settlement_status": "on_hold",
"recipient_settlement_id": null,
"created_at": 1649933574,
"processed_at": 1649933579,
"error": {
"code": null,
"description": null,
"reason": null,
"field": null,
"step": null,
"id": "trf_JJD535tJtk6Yy0",
"source": null,
"metadata": null
}
},
{
"id": "trf_JJD536GI6wuz3m",
"entity": "transfer",
"status": "processed",
"source": "pay_JGmCgTEa9OTQcX",
"recipient": "acc_IRQWUleX4BqvYn",
"amount": 300,
"currency": "MYR",
"amount_reversed": 0,
"fees": 1,
"tax": 0,
"notes": {
"name": "Siti Aisyah",
"roll_no": "IEC2011026"
},
"linked_account_notes": [
"roll_no"
],
"on_hold": false,
"on_hold_until": null,
"settlement_status": "pending",
"recipient_settlement_id": null,
"created_at": 1649933574,
"processed_at": 1649933579,
"error": {
"code": null,
"description": null,
"reason": null,
"field": null,
"step": null,
"id": "trf_JJD536GI6wuz3m",
"source": null,
"metadata": null
}
}
]
}
{
"error":{
"code":"BAD_REQUEST_ERROR",
"description":"The api key provided is invalid",
"source":"NA",
"step":"NA",
"reason":"NA",
"metadata":{
}
}
}
Route
Fetch Transfers for a Payment
Fetch Transfers for a payment using the Razorpay API.
GET
/
v1
/
payments
/
:id
/
transfers
curl -X GET https://api.razorpay.com/v1/payments/pay_JGmCgTEa9OTQcX/transfers \
-u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
RazorpayClient razorpay = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");
String paymentId = "pay_JGmCgTEa9OTQcX";
List<Payment> payments = razorpay.payments.fetchAllTransfers(paymentId)
$api = new Api($key_id, $secret);
$api->payment->fetch('payment')->transfers();
var instance = new Razorpay({ key_id: 'YOUR_KEY_ID', key_secret: 'YOUR_SECRET' })
instance.payments.fetchTransfer(paymentId)
client = razorpay.Client(auth=("YOUR_ID", "YOUR_SECRET"))
client.payment.transfers(paymentId)
require "razorpay"
Razorpay.setup('YOUR_KEY_ID', 'YOUR_SECRET')
paymentId = "pay_JGmCgTEa9OTQcX"
Razorpay::Payment.fetch(paymentId).fetch_transfer
import ( razorpay "github.com/razorpay/razorpay-go" )
client := razorpay.NewClient("YOUR_KEY_ID", "YOUR_SECRET")
body, err := client.Payment.Transfers("<paymentId>", nil, nil)
RazorpayClient client = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]
");
string paymentId = "pay_E9up5WhIfMYnKW";
List<Transfer> token = client.Payment.Fetch(paymentId).Transfers();
razorpay route transfers fetch-by-payment pay_JMNiqyuoFoJcXb
{
"entity": "collection",
"count": 2,
"items": [
{
"id": "trf_JJD535tJtk6Yy0",
"entity": "transfer",
"status": "processed",
"source": "pay_JGmCgTEa9OTQcX",
"recipient": "acc_IROu8Nod6PXPtZ",
"amount": 100,
"currency": "INR",
"amount_reversed": 0,
"fees": 1,
"tax": 0,
"notes": {
"name": "Gaurav Kumar",
"roll_no": "IEC2011025"
},
"linked_account_notes": [
"roll_no"
],
"on_hold": true,
"on_hold_until": 1671222870,
"settlement_status": "on_hold",
"recipient_settlement_id": null,
"created_at": 1649933574,
"processed_at": 1649933579,
"error": {
"code": null,
"description": null,
"reason": null,
"field": null,
"step": null,
"id": "trf_JJD535tJtk6Yy0",
"source": null,
"metadata": null
}
},
{
"id": "trf_JJD536GI6wuz3m",
"entity": "transfer",
"status": "processed",
"source": "pay_JGmCgTEa9OTQcX",
"recipient": "acc_IRQWUleX4BqvYn",
"amount": 300,
"currency": "INR",
"amount_reversed": 0,
"fees": 1,
"tax": 0,
"notes": {
"name": "Saurav Kumar",
"roll_no": "IEC2011026"
},
"linked_account_notes": [
"roll_no"
],
"on_hold": false,
"on_hold_until": null,
"settlement_status": "pending",
"recipient_settlement_id": null,
"created_at": 1649933574,
"processed_at": 1649933579,
"error": {
"code": null,
"description": null,
"reason": null,
"field": null,
"step": null,
"id": "trf_JJD536GI6wuz3m",
"source": null,
"metadata": null
}
}
]
}
{
"error":{
"code":"BAD_REQUEST_ERROR",
"description":"The api key provided is invalid",
"source":"NA",
"step":"NA",
"reason":"NA",
"metadata":{
}
}
}
{
"entity": "collection",
"count": 2,
"items": [
{
"id": "trf_JJD535tJtk6Yy0",
"entity": "transfer",
"status": "processed",
"source": "pay_JGmCgTEa9OTQcX",
"recipient": "acc_IROu8Nod6PXPtZ",
"amount": 100,
"currency": "MYR",
"amount_reversed": 0,
"fees": 1,
"tax": 0,
"notes": {
"name": "Nur Aisyah",
"roll_no": "IEC2011025"
},
"linked_account_notes": [
"roll_no"
],
"on_hold": true,
"on_hold_until": 1671222870,
"settlement_status": "on_hold",
"recipient_settlement_id": null,
"created_at": 1649933574,
"processed_at": 1649933579,
"error": {
"code": null,
"description": null,
"reason": null,
"field": null,
"step": null,
"id": "trf_JJD535tJtk6Yy0",
"source": null,
"metadata": null
}
},
{
"id": "trf_JJD536GI6wuz3m",
"entity": "transfer",
"status": "processed",
"source": "pay_JGmCgTEa9OTQcX",
"recipient": "acc_IRQWUleX4BqvYn",
"amount": 300,
"currency": "MYR",
"amount_reversed": 0,
"fees": 1,
"tax": 0,
"notes": {
"name": "Siti Aisyah",
"roll_no": "IEC2011026"
},
"linked_account_notes": [
"roll_no"
],
"on_hold": false,
"on_hold_until": null,
"settlement_status": "pending",
"recipient_settlement_id": null,
"created_at": 1649933574,
"processed_at": 1649933579,
"error": {
"code": null,
"description": null,
"reason": null,
"field": null,
"step": null,
"id": "trf_JJD536GI6wuz3m",
"source": null,
"metadata": null
}
}
]
}
{
"error":{
"code":"BAD_REQUEST_ERROR",
"description":"The api key provided is invalid",
"source":"NA",
"step":"NA",
"reason":"NA",
"metadata":{
}
}
}
Available in🇮🇳 India🇲🇾 Malaysia🇸🇬 Singapore🇺🇸 United States
Use this endpoint to retrieve the collection of all transfers created on a specific Payment id. Once the settlement against the transfer is processed, a webhook notification settlement.processed is sent which contains a recipient_settlement_id. Know more about sample webhook payloads.
curl -X GET https://api.razorpay.com/v1/payments/pay_JGmCgTEa9OTQcX/transfers \
-u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
RazorpayClient razorpay = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");
String paymentId = "pay_JGmCgTEa9OTQcX";
List<Payment> payments = razorpay.payments.fetchAllTransfers(paymentId)
$api = new Api($key_id, $secret);
$api->payment->fetch('payment')->transfers();
var instance = new Razorpay({ key_id: 'YOUR_KEY_ID', key_secret: 'YOUR_SECRET' })
instance.payments.fetchTransfer(paymentId)
client = razorpay.Client(auth=("YOUR_ID", "YOUR_SECRET"))
client.payment.transfers(paymentId)
require "razorpay"
Razorpay.setup('YOUR_KEY_ID', 'YOUR_SECRET')
paymentId = "pay_JGmCgTEa9OTQcX"
Razorpay::Payment.fetch(paymentId).fetch_transfer
import ( razorpay "github.com/razorpay/razorpay-go" )
client := razorpay.NewClient("YOUR_KEY_ID", "YOUR_SECRET")
body, err := client.Payment.Transfers("<paymentId>", nil, nil)
RazorpayClient client = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]
");
string paymentId = "pay_E9up5WhIfMYnKW";
List<Transfer> token = client.Payment.Fetch(paymentId).Transfers();
razorpay route transfers fetch-by-payment pay_JMNiqyuoFoJcXb
{
"entity": "collection",
"count": 2,
"items": [
{
"id": "trf_JJD535tJtk6Yy0",
"entity": "transfer",
"status": "processed",
"source": "pay_JGmCgTEa9OTQcX",
"recipient": "acc_IROu8Nod6PXPtZ",
"amount": 100,
"currency": "INR",
"amount_reversed": 0,
"fees": 1,
"tax": 0,
"notes": {
"name": "Gaurav Kumar",
"roll_no": "IEC2011025"
},
"linked_account_notes": [
"roll_no"
],
"on_hold": true,
"on_hold_until": 1671222870,
"settlement_status": "on_hold",
"recipient_settlement_id": null,
"created_at": 1649933574,
"processed_at": 1649933579,
"error": {
"code": null,
"description": null,
"reason": null,
"field": null,
"step": null,
"id": "trf_JJD535tJtk6Yy0",
"source": null,
"metadata": null
}
},
{
"id": "trf_JJD536GI6wuz3m",
"entity": "transfer",
"status": "processed",
"source": "pay_JGmCgTEa9OTQcX",
"recipient": "acc_IRQWUleX4BqvYn",
"amount": 300,
"currency": "INR",
"amount_reversed": 0,
"fees": 1,
"tax": 0,
"notes": {
"name": "Saurav Kumar",
"roll_no": "IEC2011026"
},
"linked_account_notes": [
"roll_no"
],
"on_hold": false,
"on_hold_until": null,
"settlement_status": "pending",
"recipient_settlement_id": null,
"created_at": 1649933574,
"processed_at": 1649933579,
"error": {
"code": null,
"description": null,
"reason": null,
"field": null,
"step": null,
"id": "trf_JJD536GI6wuz3m",
"source": null,
"metadata": null
}
}
]
}
{
"error":{
"code":"BAD_REQUEST_ERROR",
"description":"The api key provided is invalid",
"source":"NA",
"step":"NA",
"reason":"NA",
"metadata":{
}
}
}
{
"entity": "collection",
"count": 2,
"items": [
{
"id": "trf_JJD535tJtk6Yy0",
"entity": "transfer",
"status": "processed",
"source": "pay_JGmCgTEa9OTQcX",
"recipient": "acc_IROu8Nod6PXPtZ",
"amount": 100,
"currency": "MYR",
"amount_reversed": 0,
"fees": 1,
"tax": 0,
"notes": {
"name": "Nur Aisyah",
"roll_no": "IEC2011025"
},
"linked_account_notes": [
"roll_no"
],
"on_hold": true,
"on_hold_until": 1671222870,
"settlement_status": "on_hold",
"recipient_settlement_id": null,
"created_at": 1649933574,
"processed_at": 1649933579,
"error": {
"code": null,
"description": null,
"reason": null,
"field": null,
"step": null,
"id": "trf_JJD535tJtk6Yy0",
"source": null,
"metadata": null
}
},
{
"id": "trf_JJD536GI6wuz3m",
"entity": "transfer",
"status": "processed",
"source": "pay_JGmCgTEa9OTQcX",
"recipient": "acc_IRQWUleX4BqvYn",
"amount": 300,
"currency": "MYR",
"amount_reversed": 0,
"fees": 1,
"tax": 0,
"notes": {
"name": "Siti Aisyah",
"roll_no": "IEC2011026"
},
"linked_account_notes": [
"roll_no"
],
"on_hold": false,
"on_hold_until": null,
"settlement_status": "pending",
"recipient_settlement_id": null,
"created_at": 1649933574,
"processed_at": 1649933579,
"error": {
"code": null,
"description": null,
"reason": null,
"field": null,
"step": null,
"id": "trf_JJD536GI6wuz3m",
"source": null,
"metadata": null
}
}
]
}
{
"error":{
"code":"BAD_REQUEST_ERROR",
"description":"The api key provided is invalid",
"source":"NA",
"step":"NA",
"reason":"NA",
"metadata":{
}
}
}
Path Parameters
string
required
Unique identifier of the Payment for which transfers must be retrieved.
Response Parameters
string
Unique identifier of the transfer.
string
The name of the entity. Here, it is
transfer.string
The status of the transfer. Possible values are:
createdpendingprocessedfailedreversedpartially_reversed
string
The status of the settlement. Possible values are:
pendingon_holdsettled
string
Unique identifier of the transfer source. The source can be a
payment or an order.string
Unique identifier of the transfer destination, that is, the Linked Account.
integer
The amount to be transferred to the Linked Account, in paise. For example, for an amount of ₹200.35, the value of this field should be 20035.
string
ISO currency code. We support route transfers only in
INR.integer
Amount reversed from this transfer for refunds.
json object
Set of key-value pairs that can be associated with an entity. These pairs can be useful for storing additional information about the entity. A maximum of 15 key-value pairs, each of 256 characters (maximum), are supported. For example,
"region": "south", "city": "Bangalore".string
Provides error details that may occur during transfers.
string
Type of the error.
string
Error description.
string
Name of the parameter in the API request that caused the error.
string
The point of failure in the specific operation. For example, customer, business and so on.
string
The stage where the transaction failure occurred. Stages can be different depending on the payment method used to make the transaction.
string
Unique identifier of the transfer.
string
The exact error reason. It can be handled programmatically.
array
List of keys from the
notes object which needs to be shown to Linked Accounts on their Dashboard. For example, "region", "city". Only the keys will be shown, not values.boolean
Indicates whether the account settlement for transfer is on hold. Possible values:
true: Puts the settlement on hold.false: Releases the settlement.
integer
Timestamp, in Unix format, indicates until when the settlement of the transfer must be put on hold. If no value is passed, the settlement is put on hold indefinitely.
string
Unique identifier of the settlement.
integer
Timestamp, in Unix, at which the record was created.
Errors
The api key/secret provided is invalid
The api key/secret provided is invalid
Code:
4xxThis error occurs when there is a mismatch between the API credentials passed in the API call and the API credentials generated on the Dashboard.Solution: Make sure the API Keys are active and entered correctly. Also, there should not be any whitespaces before or after the keys.payment_id is not a valid id
payment_id is not a valid id
Code:
400This error occurs when you pass an invalid payment_id in the API endpoint.Solution: Make sure to pass a vaild payment_id.Last modified on October 8, 2026
Was this page helpful?