Docs Logo

Fund Accounts

Create a Fund Account of Type Bank Account

Create a Fund Account of Type VPA

Fetch All Fund Accounts

Fetch a Fund Account With ID

Activate or Deactivate a Fund Account

Docs Logo
Docs AI persona

Docs AI

Beta

API Test keys

Api

X

Fund Accounts

Create

Bank Account

API Test keys

Api

X

Fund Accounts

Create

Bank Account

Create a Fund Account of Type Bank Account

POST
/v1/fund_accounts

Click to copy

Use this endpoint to create a fund account with bank account details.

  • A new fund account is created if any combination of the following details is unique: contact_id, bank_account.name, bank_account.ifsc and bank_account.account_number.
  • If all the above details match the details of an existing fund account, the API returns details of the existing fund account.
  • You cannot edit the details of a fund account.

Is this page helpful?

Curl

1
curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
2
-X POST https://api.razorpay.com/v1/fund_accounts \
3
-H "Content-Type: application/json" \
4
-d '{
5
  "contact_id":"cont_00000000000001",
6
  "account_type":"bank_account",
7
  "bank_account":{
8
    "name":"Gaurav Kumar",
9
    "ifsc":"HDFC0000053",
10
    "account_number":"765432123456789"
11
  }
12
}'

Success

1
{
2
  "id" : "fa_00000000000001",
3
  "entity": "fund_account",
4
  "contact_id" : "cont_00000000000001",
5
  "account_type": "bank_account",
6
  "bank_account": {
7
    "ifsc": "HDFC0000053",
8
    "bank_name": "HDFC Bank",
9
    "name": "Gaurav Kumar",
10
    "account_number": "765432123456789",
11
    "notes": []
12
  },
13
  "active": true,
14
  "batch_id": null,
15
  "created_at": 1543650891
16
}
Request Parameters
contact_id

*

string

This is the unique identifier linked to a contact. For example, cont_00000000000001.

account_type

*

string

The account type you want to link to the contact ID. Here it is bank_account.

bank_account

*

object

The contact's bank account details.

Show child parameters (3)

Response Parameters
id
string

The unique identifier linked to the fund account. For example, fa_00000000000001.

entity
string

Here it will be fund_account.

contact_id
string

The unique identifier linked to the contact. For example, cont_00000000000001.

account_type
string

The fund account type being created. Here it will either be bank_account, vpa or card.

Show child parameters (3)

active
boolean

Possible values of Fund Account status:

  • true: active
  • false: inactive

batch_id
string

This value is returned if the fund account was created as part of a bulk upload.
For example, batch_00000000000001.

created_at
integer

Timestamp, in Unix, when the fund account was created. For example, 1543650891.

Errors

The contact id provided does not exist.

Error Status: 4xx

The contact ID provided is incorrect.

Solution

The IFSC must be 11 characters.

Error Status: 4xx

The IFSC code provided is either incorrect or does not have 11 characters.

Solution

The account number format is invalid.

Error Status: 4xx

The account number is incorrect.

Solution

Create a Fund Account of Type Bank Account

POST
/v1/fund_accounts

Click to copy

Use this endpoint to create a fund account with bank account details.

  • A new fund account is created if any combination of the following details is unique: contact_id, bank_account.name, bank_account.ifsc and bank_account.account_number.
  • If all the above details match the details of an existing fund account, the API returns details of the existing fund account.
  • You cannot edit the details of a fund account.

Is this page helpful?

Request Parameters
contact_id

*

string

This is the unique identifier linked to a contact. For example, cont_00000000000001.

account_type

*

string

The account type you want to link to the contact ID. Here it is bank_account.

bank_account

*

object

The contact's bank account details.

Show child parameters (3)

Response Parameters
id
string

The unique identifier linked to the fund account. For example, fa_00000000000001.

entity
string

Here it will be fund_account.

contact_id
string

The unique identifier linked to the contact. For example, cont_00000000000001.

account_type
string

The fund account type being created. Here it will either be bank_account, vpa or card.

Show child parameters (3)

active
boolean

Possible values of Fund Account status:

  • true: active
  • false: inactive

batch_id
string

This value is returned if the fund account was created as part of a bulk upload.
For example, batch_00000000000001.

created_at
integer

Timestamp, in Unix, when the fund account was created. For example, 1543650891.

Errors

The contact id provided does not exist.

Error Status: 4xx

The contact ID provided is incorrect.

Solution

The IFSC must be 11 characters.

Error Status: 4xx

The IFSC code provided is either incorrect or does not have 11 characters.

Solution

The account number format is invalid.

Error Status: 4xx

The account number is incorrect.

Solution

Curl

1
curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
2
-X POST https://api.razorpay.com/v1/fund_accounts \
3
-H "Content-Type: application/json" \
4
-d '{
5
  "contact_id":"cont_00000000000001",
6
  "account_type":"bank_account",
7
  "bank_account":{
8
    "name":"Gaurav Kumar",
9
    "ifsc":"HDFC0000053",
10
    "account_number":"765432123456789"
11
  }
12
}'

Success

1
{
2
  "id" : "fa_00000000000001",
3
  "entity": "fund_account",
4
  "contact_id" : "cont_00000000000001",
5
  "account_type": "bank_account",
6
  "bank_account": {
7
    "ifsc": "HDFC0000053",
8
    "bank_name": "HDFC Bank",
9
    "name": "Gaurav Kumar",
10
    "account_number": "765432123456789",
11
    "notes": []
12
  },
13
  "active": true,
14
  "batch_id": null,
15
  "created_at": 1543650891
16
}