> ## Documentation Index
> Fetch the complete documentation index at: https://razorpay-881012b3.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Customer Fund Account APIs

> Create and fetch a Fund account for a Customer.

<div style={{display:"flex",flexWrap:"wrap",alignItems:"center",gap:"0.35rem 0.9rem",border:"1px solid rgba(128,128,128,0.28)",borderRadius:"0.5rem",padding:"0.45rem 0.75rem",margin:"0 0 1.25rem",fontSize:"0.875rem"}}>
  <span style={{fontWeight:600}}>Available in</span>
  <span>🇮🇳 India</span>
</div>

Using Razorpay APIs, you can create a fund account for a customer. Know more about [customers](/docs/payments/customers).

## Create a Fund Account

You can use the below endpoint to create a fund account for a customer.

`POST /fund_accounts`

<CodeGroup>
  ```bash Curl theme={null}
  curl -u <YOUR_KEY>:<YOUR_SECRET> \
  -X POST https://api.razorpay.com/v1/fund_accounts \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id":"cust_Aa000000000001",
    "account_type":"bank_account",
    "bank_account":{
      "name":"Gaurav Kumar",
      "account_number":"11214311215411",
      "ifsc":"HDFC0000053"
    }
  }'
  ```

  ```java Java theme={null}
  RazorpayClient razorpay = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");

  JSONObject fundAccountRequest = new JSONObject();
  fundAccountRequest.put("customer_id", "cust_JDdNazagOgg9Ig");
  fundAccountRequest.put("account_type", "bank_account");
  JSONObject bankAccount = new JSONObject();
  bankAccount.put("name","Gaurav Kumar");
  bankAccount.put("account_number","11214311215411");
  bankAccount.put("ifsc","HDFC0000053");
  fundAccountRequest.put("bank_account", bankAccount);

  FundAccount fundaccount = razorpay.fundAccount.create(fundAccountRequest);
  ```

  ```python Python theme={null}
  import razorpay
  client = razorpay.Client(auth=("YOUR_ID", "YOUR_SECRET"))

  client.fund_account.create({
    "customer_id":"cust_Aa000000000001",
    "account_type":"bank_account",
    "bank_account":{
      "name":"Gaurav Kumar",
      "account_number":"11214311215411",
      "ifsc":"HDFC0000053"
    }
  })
  ```

  ```php PHP theme={null}
  $api = new Api($key_id, $secret);

  $api->fundAccount->create(array('customer_id'=>$customerId,'account_type'=>'bank_account','bank_account'=>array('name'=>'Gaurav Kumar', 'account_number'=>'11214311215411', 'ifsc'=>'HDFC0000053')))
  ```

  ```ruby Ruby theme={null}
  require "razorpay"
  Razorpay.setup('YOUR_KEY_ID', 'YOUR_SECRET')

  para_attr = {
    "customer_id":"cust_Aa000000000001",
    "account_type":"bank_account",
    "bank_account":{
      "name":"Gaurav Kumar",
      "account_number":"11214311215411",
      "ifsc":"HDFC0000053"
    }
  }

  Razorpay::FundAccount.create(data)
  ```

  ```javascript Node.js theme={null}
  var instance = new Razorpay({ key_id: 'YOUR_KEY_ID', key_secret: 'YOUR_SECRET' })

  instance.fundAccount.create({
    "customer_id":"cust_Aa000000000001",
    "account_type":"bank_account",
    "bank_account":{
      "name":"Gaurav Kumar",
      "account_number":"11214311215411",
      "ifsc":"HDFC0000053"
    }
  })
  ```

  ```go Go theme={null}
  import ( razorpay "github.com/razorpay/razorpay-go" )
  client := razorpay.NewClient("YOUR_KEY_ID", "YOUR_SECRET")

  data:= map[string]interface{}{
    "customer_id":"cust_Aa000000000001",
    "account_type":"bank_account",
    "bank_account":map[string]interface{}{
      "name":"Gaurav Kumar",
      "account_number":"11214311215411",
      "ifsc":"HDFC0000053",
    },
  }
  body, err := client.FundAccount.Create(data, nil)
  ```

  ```csharp .NET theme={null}
  RazorpayClient client = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");

  Dictionary<string, object> fundAccountRequest = new Dictionary<string, object>();
  fundAccountRequest.Add("customer_id", "cust_Z6t7VFTb9xHeOs");
  fundAccountRequest.Add("account_type", "bank_account");
  Dictionary<string, object> bankAccount = new Dictionary<string, object>();
  bankAccount.Add("name","Gaurav Kumar");
  bankAccount.Add("account_number","11214311215411");
  bankAccount.Add("ifsc","HDFC0000053");
  fundAccountRequest.Add("bank_account", bankAccount);

  FundAccount fundaccount = client.FundAccount.Create(fundAccountRequest);
  ```

  ```json Response theme={null}
  {
    "id": "fa_JiT6rz7uEpG3B4",
    "entity": "fund_account",
    "customer_id": "cust_JfrT7i6et3JjFf",
    "account_type": "bank_account",
    "bank_account": {
      "ifsc": "HDFC0000053",
      "bank_name": "HDFC Bank",
      "name": "Gaurav Kumar",
      "notes": [],
      "account_number": "11214311215411"
    },
    "batch_id": null,
    "active": true,
    "created_at": 1655448526
  }
  ```
</CodeGroup>

### Request Parameters

`customer_id` *mandatory*
: `string` This is the unique ID linked to a customer. For example, `cust_Aa000000000001`.

`account_type` *mandatory*
: `string` The type of account to be linked to the customer ID. In this case it will be `bank_account`.

`bank_account`
: `object` Customer bank account details.

`name` *mandatory*
: `string` Name of account holder as per bank records. For example, `Gaurav Kumar`.

`ifsc` *mandatory*
: `string` Customer's bank IFSC. For example, `HDFC0000053`.

`account_number` *mandatory*
: `string` Beneficiary account number. For example, `11214311215411`.

### Response Parameters

`id`
: `string` The unique ID linked to the fund account. For example, `fa_Aa000000000001`.

`entity`
: `string` The name of the Razorpay entity. In this case it will be `fund_account`.

`customer_id`
: `string` This is the unique ID linked to a customer. For example, `cust_Aa000000000001`.

`account_type`
: `string` The type of account to be linked to the customer ID. In this case it will be `bank_account`.

`bank_account`
: `object` Customer bank account details.

`name`
: `string` Name of account holder as per bank records. For example, `Gaurav Kumar`.

`account_number`
: `string` Beneficiary account number. For example, `11214311215411`.

`ifsc`
: `string` Customer's bank IFSC. For example, `HDFC0000053`.

`bank_name`
: `string` Customer's bank name. For example `HDFC`.

`active`
: `string` Status of the fund account. Possible values:

* `true`: Fund account is active.
* `false`: Fund account is inactive.

`created_at`
: `integer` The time at which the account was created at Razorpay. The output for this parameter is date and time in the Unix format, for example, `1543650891`.<br />

## Fetch all Fund Accounts

You can use the below endpoint to fetch all fund accounts linked to your account.

<CodeGroup>
  ```bash Curl theme={null}
  curl -u <YOUR_KEY>:<YOUR_SECRET> \
  -X GET https://api.razorpay.com/v1/fund_accounts?customer_id=cust_Aa000000000001
  ```

  ```java Java theme={null}
  RazorpayClient razorpay = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");

  String customerId = "cust_Aa000000000001";

  FundAccount fundaccount = razorpay.fundAccount.fetch(customerId);
  ```

  ```python Python theme={null}
  import razorpay
  client = razorpay.Client(auth=("YOUR_ID", "YOUR_SECRET"))

  client.fund_account.fetch(customerId)
  ```

  ```php PHP theme={null}
  $api = new Api($key_id, $secret);

  $api->fundAccount->all(array('customer_id'=>$customerIds));
  ```

  ```ruby Ruby theme={null}
  require "razorpay"
  Razorpay.setup('YOUR_KEY_ID', 'YOUR_SECRET')

  para_attr = {
      "customer_id": "cust_Aa000000000001"
  }
  Razorpay::FundAccount.all(para_attr)
  ```

  ```javascript Node.js theme={null}
  var instance = new Razorpay({ key_id: 'YOUR_KEY_ID', key_secret: 'YOUR_SECRET' })

  instance.fundAccount.fetch(customerId)
  ```

  ```go Go theme={null}
  import ( razorpay "github.com/razorpay/razorpay-go" )
  client := razorpay.NewClient("YOUR_KEY_ID", "YOUR_SECRET")

  data := map[string]interface{}{
      "customer_id":"cust_Aa000000000001",
  }
  body, err := client.FundAccount.All(data, nil)
  ```

  ```csharp .NET theme={null}
  RazorpayClient client = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");

  Dictionary<string, object> fundAccountRequest = new Dictionary<string, object>();
  fundAccountRequest.Add("customer_id","cust_Z6t7VFTb9xHeOs");

  List<FundAccount> fundaccount = client.FundAccount.All(fundAccountRequest);
  ```

  ```json Response theme={null}
  {
    "entity": "collection",
    "count": 1,
    "items": [
      {
        "id": "fa_JiT6rz7uEpG3B4",
        "entity": "fund_account",
        "customer_id": "cust_Aa000000000001",
        "account_type": "bank_account",
        "bank_account": {
          "ifsc": "HDFC0000053",
          "bank_name": "HDFC Bank",
          "name": "Gaurav Kumar",
          "notes": [],
          "account_number": "11214311215411"
        },
        "batch_id": null,
        "active": true,
        "created_at": 1655448526
      }
    ]
  }
  ```
</CodeGroup>

### Query Parameter

`customer_id` *mandatory*
: `string` This is the unique ID linked to a customer. For example, `cust_Aa000000000001`.