API Test Keys

Fetch Settlement Details

GET
/v1/transfers?expand[]=recipient_settlement

Click to copy

Use this endpoint to fetch details of settlements made to Linked Accounts. You should append ?expand[]=recipient_settlement as the query parameter to the fetch transfer request. This would return a settlement entity and the transfer entity.

Is this page helpful?

Curl

change language

change language

1
curl -X GET https://api.razorpay.com/v1/transfers?expand[]=recipient_settlement \
2
-u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \

Success

Failure

1
{
2
"entity":"collection",
3
"count":2,
4
"items":[
5
{
6
"id":"trf_LQzChWyKaanhLt",
7
"entity":"transfer",
8
"status":"processed",
9
"source":"pay_LObWTFZaMBE09S",
10
"recipient":"acc_LQDB1eV0EnS808",
11
"account_code":"sartest",
12
"amount":200,
13
"currency":"INR",
14
"amount_reversed":0,
15
"fees":0,
16
"tax":0,
17
"notes":[
18
19
],
20
"linked_account_notes":[
21
22
],
23
"on_hold":false,
24
"on_hold_until":null,
25
"settlement_status":"settled",
26
"recipient_settlement_id":"setl_LRfWxcxaJyXwde",
27
"recipient_settlement":{
28
"id":"setl_LRfWxcxaJyXwde",
29
"entity":"settlement",
30
"amount":200,
31
"status":"processed",
32
"fees":0,
33
"tax":0,
34
"utr":"cg8kkuoffu3jpb4k8hgg",
35
"created_at":1678854659
36
},
37
"created_at":1678705600,
38
"processed_at":1678705601,
39
"error":{
40
"code":null,
41
"description":null,
42
"reason":null,
43
"field":null,
44
"step":null,
45
"id":"trf_LQzChWyKaanhLt",
46
"source":null,
47
"metadata":null
48
},
49
"source_channel":"online"
50
},
51
{
52
"id":"trf_Ks9IagO4T2wZ5l",
53
"entity":"transfer",
54
"status":"processed",
55
"source":"pay_Ks9IUPU43z3FRz",
56
"recipient":"acc_H9sehmPXd5nd2n",
57
"account_code":"Palguna_test",
58
"amount":100000,
59
"currency":"INR",
60
"amount_reversed":0,
61
"fees":0,
62
"tax":0,
63
"notes":[
64
65
],
66
"linked_account_notes":[
67
68
],
69
"on_hold":false,
70
"on_hold_until":null,
71
"settlement_status":"settled",
72
"recipient_settlement_id":"setl_KstcJycgGX6lRa",
73
"recipient_settlement":{
74
"id":"setl_KstcJycgGX6lRa",
75
"entity":"settlement",
76
"amount":200000,
77
"status":"processed",
78
"fees":0,
79
"tax":0,
80
"utr":"ceen24sa13gn9rr3uij0",
81
"created_at":1671262362
82
},
83
"created_at":1671099247,
84
"processed_at":1671099247,
85
"error":{
86
"code":null,
87
"description":null,
88
"reason":null,
89
"field":null,
90
"step":null,
91
"id":"trf_Ks9IagO4T2wZ5l",
92
"source":null,
93
"metadata":null
94
},
95
"source_channel":"online"
96
}
97
]
98
}
Query Parameters
expand

*

string

Used to retrieve settlement entity along with transfer entity. Supported value is recipient_settlement.

Response Parameters
id
string

Unique identifier of the transfer.

entity
string

The name of the entity. Here, it is transfer.

transfer_status
string

The status of the transfer. Possible values are:

  • created
  • pending
  • processed
  • failed
  • reversed
  • partially_reversed

settlement_status
string

The status of the settlement. Possible values are:

  • pending
  • on_hold
  • settled

source
string

Unique identifier of the transfer source. The source can be a payment or an order.

recipient
string

Unique identifier of the transfer destination, that is, the Linked Account.

amount
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.

currency
string

ISO currency code. We support route transfers only in INR.

amount_reversed
integer

Amount reversed from this transfer for refunds.

notes
json object

Set of key-value pairs that can be associated with an entity. This can be useful for storing additional information about the entity. A maximum of 15 key-value pairs, each of 256 characters (maximum), are supported.

on_hold
boolean

Indicates whether the account settlement for transfer is on hold. Possible values:

  • 1 - Puts the settlement on hold.
  • 0 - Releases the settlement.

on_hold_until
integer

Timestamp, in Unix, that 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.

recipient_settlement_id
string

Unique identifier of the settlement.

recipient_settlement
array

Show child parameters (8)

linked_account_notes
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.

created_at
integer

Timestamp, in Unix, at which the transfer was created.

processed_at
integer

Timestamp, in Unix, at which the transfer was processed.

error
array

Provides error details that may occur during transfers.

Show child parameters (6)

source_channel
string

Medium through which transfers were created. For example, online.

Errors

The api key/secret provided is invalid

Error Status: 4xx

This 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

Fetch Settlement Details

GET
/v1/transfers?expand[]=recipient_settlement

Click to copy

Use this endpoint to fetch details of settlements made to Linked Accounts. You should append ?expand[]=recipient_settlement as the query parameter to the fetch transfer request. This would return a settlement entity and the transfer entity.

Is this page helpful?

Query Parameters
expand

*

string

Used to retrieve settlement entity along with transfer entity. Supported value is recipient_settlement.

Response Parameters
id
string

Unique identifier of the transfer.

entity
string

The name of the entity. Here, it is transfer.

transfer_status
string

The status of the transfer. Possible values are:

  • created
  • pending
  • processed
  • failed
  • reversed
  • partially_reversed

settlement_status
string

The status of the settlement. Possible values are:

  • pending
  • on_hold
  • settled

source
string

Unique identifier of the transfer source. The source can be a payment or an order.

recipient
string

Unique identifier of the transfer destination, that is, the Linked Account.

amount
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.

currency
string

ISO currency code. We support route transfers only in INR.

amount_reversed
integer

Amount reversed from this transfer for refunds.

notes
json object

Set of key-value pairs that can be associated with an entity. This can be useful for storing additional information about the entity. A maximum of 15 key-value pairs, each of 256 characters (maximum), are supported.

on_hold
boolean

Indicates whether the account settlement for transfer is on hold. Possible values:

  • 1 - Puts the settlement on hold.
  • 0 - Releases the settlement.

on_hold_until
integer

Timestamp, in Unix, that 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.

recipient_settlement_id
string

Unique identifier of the settlement.

recipient_settlement
array

Show child parameters (8)

linked_account_notes
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.

created_at
integer

Timestamp, in Unix, at which the transfer was created.

processed_at
integer

Timestamp, in Unix, at which the transfer was processed.

error
array

Provides error details that may occur during transfers.

Show child parameters (6)

source_channel
string

Medium through which transfers were created. For example, online.

Errors

The api key/secret provided is invalid

Error Status: 4xx

This 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

Curl

change language

change language

1
curl -X GET https://api.razorpay.com/v1/transfers?expand[]=recipient_settlement \
2
-u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \

Success

Failure

1
{
2
"entity":"collection",
3
"count":2,
4
"items":[
5
{
6
"id":"trf_LQzChWyKaanhLt",
7
"entity":"transfer",
8
"status":"processed",
9
"source":"pay_LObWTFZaMBE09S",
10
"recipient":"acc_LQDB1eV0EnS808",
11
"account_code":"sartest",
12
"amount":200,
13
"currency":"INR",
14
"amount_reversed":0,
15
"fees":0,
16
"tax":0,
17
"notes":[
18
19
],
20
"linked_account_notes":[
21
22
],
23
"on_hold":false,
24
"on_hold_until":null,
25
"settlement_status":"settled",
26
"recipient_settlement_id":"setl_LRfWxcxaJyXwde",
27
"recipient_settlement":{
28
"id":"setl_LRfWxcxaJyXwde",
29
"entity":"settlement",
30
"amount":200,
31
"status":"processed",
32
"fees":0,
33
"tax":0,
34
"utr":"cg8kkuoffu3jpb4k8hgg",
35
"created_at":1678854659
36
},
37
"created_at":1678705600,
38
"processed_at":1678705601,
39
"error":{
40
"code":null,
41
"description":null,
42
"reason":null,
43
"field":null,
44
"step":null,
45
"id":"trf_LQzChWyKaanhLt",
46
"source":null,
47
"metadata":null
48
},
49
"source_channel":"online"
50
},
51
{
52
"id":"trf_Ks9IagO4T2wZ5l",
53
"entity":"transfer",
54
"status":"processed",
55
"source":"pay_Ks9IUPU43z3FRz",
56
"recipient":"acc_H9sehmPXd5nd2n",
57
"account_code":"Palguna_test",
58
"amount":100000,
59
"currency":"INR",
60
"amount_reversed":0,
61
"fees":0,
62
"tax":0,
63
"notes":[
64
65
],
66
"linked_account_notes":[
67
68
],
69
"on_hold":false,
70
"on_hold_until":null,
71
"settlement_status":"settled",
72
"recipient_settlement_id":"setl_KstcJycgGX6lRa",
73
"recipient_settlement":{
74
"id":"setl_KstcJycgGX6lRa",
75
"entity":"settlement",
76
"amount":200000,
77
"status":"processed",
78
"fees":0,
79
"tax":0,
80
"utr":"ceen24sa13gn9rr3uij0",
81
"created_at":1671262362
82
},
83
"created_at":1671099247,
84
"processed_at":1671099247,
85
"error":{
86
"code":null,
87
"description":null,
88
"reason":null,
89
"field":null,
90
"step":null,
91
"id":"trf_Ks9IagO4T2wZ5l",
92
"source":null,
93
"metadata":null
94
},
95
"source_channel":"online"
96
}
97
]
98
}