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

# Update an Account

> Update account with Razorpay Curlec Partners sub-merchant onboarding APIs.

Available in
🇮🇳 India
🇲🇾 Malaysia
🇺🇸 United States

Use this endpoint to update the details of a sub-merchant account.

The information you can update using the Update an Account API differs based on the product activation status.

| Activation Status | Update Permitted |
| - | - |
| `requested` | You can update the details for all the fields. |
| `needs_clarification` | The fields you can update depend on the `reason_code` mentioned in the `requirements` object in the [Request a Product Activation API](https://razorpay.com/docs/my/api/partners/product-configuration/request.md): <ul><li>**document\_missing** or **field\_missing**: You can update all the fields.</li><li>**needs\_clarification**: You can update only the specific field for which Razorpay Curlec is seeking clarification for.</li></ul> |
| `under_review` | You cannot update any fields. |
| `activated` | You cannot use this API to update any fields as your account is already active. |

> [!WARNING]
>
> **Watch Out!**
>
> Currently, we do not support making concurrent requests to the following Onboarding APIs including their combination on the same `account_id`:
>
> * Update Account API
> * Update Stakeholder API
> * [Update Product Configuration API](https://razorpay.com/docs/my/api/partners/product-configuration/update-settlement-account-details.md)
>
> Please wait for the response of these APIs before making subsequent requests.

Know about the various error responses for this API.

```bash Curl theme={null}
curl -X PATCH https://api.razorpay.com/v2/accounts/acc_GP4lfNA0iIMn5B \
-u <ACCESS_TOKEN> \
-H "Content-Type: application/json" \
-d '{
	"customer_facing_business_name": "ABCD Ltd"
}'
```

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

String accountId = "acc_GP4lfNA0iIMn5B";

JSONObject accountRequest = new JSONObject();
accountRequest.put("customer_facing_business_name","ABCD Ltd");

Account account = instance.account.edit(accountId,accountRequest);
```

```php PHP theme={null}
$api = new Api(null, null, "<ACCESS_TOKEN>");

$accountId = "acc_GP4lfNA0iIMn5B";
$api->account->edit($accountId,array(
   "customer_facing_business_name" => "ABCD Ltd"
));
```

```javascript Node.js theme={null}
const instance = new Razorpay({
  oauthToken: "<ACCESS_TOKEN>"
);

const accountId = "acc_GP4lfNA0iIMn5B";

instance.accounts.edit(accountId,{
	"customer_facing_business_name": "ABCD Ltd"
});
```

```ruby Ruby theme={null}
require "razorpay"
Razorpay.setup('ACCESS_TOKEN')
accountId = "acc_GP4lfNA0iIMn5B";

Razorpay::Account.edit(accountId,{
	"customer_facing_business_name": "ABCD Ltd"
})
```

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

string accountId = "acc_ua2tBezhcEBvap";

Dictionary<string, object> accountRequest = new Dictionary<string, object>();
accountRequest.Add("customer_facing_business_name", "Example");

Account account = client.Account.Fetch(accountId).Edit(accountRequest);
```

```json Success theme={null}
{
  "id": "acc_GP4lfNA0iIMn5B",
  "type": "standard",
  "status": "created",
  "email": "gauri@example.org",
  "profile": {
    "category": "healthcare",
    "subcategory": "clinic",
    "addresses": {
      "registered": {
        "street1": "507, Koramangala 1st block",
        "street2": "MG Road-1",
        "city": "Bengalore",
        "state": "KARNATAKA",
        "postal_code": "560034",
        "country": "IN"
      }
    }
  },
  "notes": [],
  "created_at": 1610603081,
  "phone": "9000090000",
  "reference_id": "randomId",
  "business_type": "partnership",
  "legal_business_name": "Acme Corp",
  "customer_facing_business_name": "ABCD Ltd"
}
```

## Path Parameters

**account\_id** `string` *required*

The unique identifier of a sub-merchant account generated by Razorpay Curlec. For example, `acc_GP4lfNA0iIMn5B`.

## Response Parameters

**id** `string`

The unique identifier of a sub-merchant account generated by Razorpay Curlec. The maximum length is 18 characters. For example, `acc_GLGeLkU2JUeyDZ`.

**type** `string`

The account type. Possible value is `standard`.

**status** `string`

The status of the account. Possible values:

* `created`: Account status when the merchant account is created.
* `activated`: Account status when the merchant KYC is approved.
* `needs_clarification`: Account status when the merchant is asked to provide clarifications related to the KYC details submitted.
* `under_review`: Account status when the merchant submits all the KYC requirements.
* `suspended`: Account status when the merchant account is identified as potentially fraudulent and is suspended.
* `rejected`: Account status when the KYC details submitted by the merchant are rejected during manual review.

**email** `string`

The sub-merchant's business email address.

**phone** `integer`

The sub-merchant's business phone number. The minimum length is 8 characters and the maximum length is 15.

**legal\_business\_name** `string`

The name of the sub-merchant's business. For example, `Acme Corp`. The minimum length is 4 characters and the maximum length is 200.

**customer\_facing\_business\_name** `string`

The sub-merchant billing label as it appears on the Dashboard. The minimum length is 1 character and the maximum length is 255. This parameter might be required to complete the KYC process. However, it is optional for this API.

**business\_type** `string`

The type of business operated by the sub-merchant. Possible values: Business Types.

**reference\_id** `string`

Partner's external account reference id. The minimum length is 1 character and the maximum length is 512.

**profile** `object`

The business details of the sub-merchant's account.

**category** `string`

The business category of the sub-merchant. Possible values: Business Category

**subcategory** `string`

The business sub-category of the sub-merchant. Possible values: Business Sub-Category

**description** `string`

This parameter has been deprecated. Pass the description using the `business_model` parameter.

**business\_model** `string`

The business description. The minimum length is 1 character and the maximum length is 255.

**addresses** `object`

Details of sub-merchant's address.\\

**operation** `object`

Details of the sub-merchant's operational address. This parameter might be required to complete the KYC process. However, it is optional for this API.

**street1** `string`

Address, line 1. The maximum length is 100 characters.

**street2** `string`

Address, line 2. The maximum length is 100 characters.

**city** `string`

The city. The maximum length is 100 characters.

**state** `string`

The state. The minimum length is 2 and the maximum length is 100.

**postal\_code** `integer`

The postal code. This should be exactly 6 characters.

**country** `string`

The country. The minimum length is 2 and the maximum length is 64. This can either be a country code in capital letters or the full name of the country in lower case letters. For example, for India, you must write either `IN` or `india`. List of supported Countries.

**registered** `object`

Details of the sub-merchant's registered address.

**street1** `string`

Address, line 1. The maximum length is 100 characters.

**street2** `string`

Address, line 2. The maximum length is 100 characters.

**city** `string`

The city. The maximum length is 100 characters.

**state** `string`

The state. The minimum length is 2 and the maximum length is 100.

**postal\_code** `integer`

The postal code. This should be exactly 6 characters.

**country** `string`

The country. The minimum length is 2 and the maximum length is 64. This can either be a country code in capital letters or the full name of the country in lower case letters. For example, for India, you must write either `IN` or `india`. List of supported Countries.

**legal\_info** `object`

The legal details about the sub-merchant's business.

**pan** `string`

Valid PAN number details of the sub-merchant's business.

* This is a 10-digit alphanumeric code. For example, `AVOJB1111K`.
* The 4th digit should be either of 'C', 'H', 'F', 'A', 'T', 'B', 'J', 'G', 'L'.
* The regex for Company PAN is `/^[a-zA-z]{5}\d{4}[a-zA-Z]{1}$/`.\
  &#x20;This parameter might be required to complete the KYC process. However, it is optional for this API.

**gst** `string`

Valid GSTIN number details of the sub-merchant.

* This is a 15-digit PAN-based unique identification number.
* The Regex for GSTIN is `/^[0123][0-9][a-z]{5}[0-9]{4}[a-z][0-9][a-z0-9][a-z0-9]$/gi`.

**cin** `string`

CIN is for Private Limited and Public Limited, whereas LLPIN is for LLP business type.

* This is a 21-digit alpha-numeric number.
* The Regex for CIN is `/^([a-z]{3}-\d{4}|[ul]\d{5}[a-z]{2}\d{4}[a-z]{3}\d{6})$/i`.

**brand** `object`

The branding details of the sub-merchant's business.

**color** `string`

The color code of sub-merchant's business brand. This is a 6-character hex code (Regex: \[a-fA-F0-9]\{6}).

**notes** `object`

Contains user-defined fields stored by the partner for reference purposes.

**contact\_name** `string`

The name of the contact. The minimum length is 4 and the maximum length is 255 characters.

**contact\_info** `object`

Options available for contact support.

**chargeback** `object`

The type of contact support.

**email** `string`

The email id of chargeback POC. The maximum length is:

* local part (before @): 64 characters.
* domain part (after @): 68 characters. \
  &#x20;The total character length supported is 132.

**phone** `integer`

The phone number of chargeback POC. The maximum length is 10 characters.

**policy\_url** `string`

The URL of chargeback policy. Regex is (protocol://`razorpay.com`:port/resource path?querystring#fragementid)\
&#x20;protocol-both http/https allowed. Only domain name is mandatory.

**refund** `object`

The type of contact support.

**email** `string`

The email id of refund POC. The maximum length is:

* local part (before @): 64 characters.
* domain part (after @): 68 characters. \
  &#x20;The total character length supported is 132.

**phone** `integer`

The phone number of refund POC. The maximum length is 10 characters.

**policy\_url** `string`

The URL of refund policy. Regex is (protocol://`razorpay.com`:port/resource path?querystring#fragementid) \
&#x20;protocol-both http/https allowed.

**support** `array`

The type of contact support.

**email** `string`

The email id of support POC. The maximum length is:

* local part (before @): 64 characters.
* domain part (after @): 68 characters. \
  &#x20;The total character length supported is 132.

**phone** `integer`

The phone number of support POC. The maximum length is 10 characters.

**policy\_url** `string`

The URL of support policy. Regex is (protocol://`razorpay.com`:port/resource path?querystring#fragementid) \
&#x20;protocol-both http/https allowed.

**apps** `object`

The app details of the sub-merchant's business

**websites** `array`

The website/app for the sub-merchant's business. A minimum of 1 website is required.

**android** `array`

Android app details

**url** `string`

The link of the Android app. Regex is (protocol://`razorpay.com`:port/resource path?querystring#fragementid) \
&#x20;protocol-both http/https allowed.

**name** `string`

The name of the Android app.

**ios** `array`

iOS app details

**url** `string`

The link of the iOS app. Regex is (protocol://`razorpay.com`:port/resource path?querystring#fragementid) \
&#x20;protocol-both http/https allowed.

**name** `string`

The name of the iOS app.

**activated\_at** `integer`

Unix timestamp that indicates when the merchant account was activated. This parameter has `null` value till the account is activated.

**live** `boolean`

Indicates the payments acceptance status of the merchant account. Possible values:

* `true`:  Merchant can start accepting customer payments.
* `false`: Merchant cannot accept customer payments.

**hold\_funds** `boolean`

Indicates the settlements status of the merchant account. Possible values:

* `true`:  Settlement are on hold. Funds are not transferred to the merchant account.
* `false`: Settlements can be transferred to the merchant account.
