Update a Linked Account

curl -X PATCH https://api.razorpay.com/v2/accounts/acc_LWXFUBYnysbYFV \
-u <YOUR_KEY_ID>:<YOUR_KEY_SECRET> \
-H "Content-type: application/json" \
-d '{
  "legal_business_name": "Acme Corp V2",
  "profile": {
    "addresses": {
      "operation": {
        "street1": "5071, Koramangala 6th block",
        "street2": "Kormanagala",
        "city": "Bengaluru",
        "state": "Karnataka",
        "postal_code": 560047,
        "country": "IN"
      }
    }
  },
  "legal_info": {
    "pan": "BAACL1234C",
    "gst": "10AABCU9603R1ZM"
  }
}'

razorpay route accounts update acc_IEIkSOM5VJb2Lm \
  --phone 9000000000 \
  --customer-facing-business-name "Acme New Name" \
  --profile-category healthcare \
  --profile-subcategory diagnostics \
  --support-email newsupport@acme.example.com \
  --pan AAAPL1234C

{
  "id": "acc_LWXFUBYnysbYFV",
  "type": "route",
  "status": "created",
  "email": "gaurava.kumar@example.com",
  "profile": {
    "category": "healthcare",
    "subcategory": "clinic",
    "addresses": {
      "registered": {
        "street1": "507, Koramangala 1st block",
        "street2": "MG Road",
        "city": "Bengaluru",
        "state": "KARNATAKA",
        "postal_code": "560034",
        "country": "IN"
      },
      "operation": {
        "street1": "5071, Koramangala 6th block",
        "street2": "Kormanagala",
        "city": "Bengaluru",
        "state": "KARNATAKA",
        "country": "IN",
        "postal_code": 560047
      }
    }
  },
  "notes": [],
  "created_at": 1679917193,
  "phone": "+919000090000",
  "contact_name": "Gaurav Kumar",
  "reference_id": "124126",
  "business_type": "partnership",
  "legal_business_name": "Acme Corp V2",
  "customer_facing_business_name": "Acme Corp V2",
  "legal_info": {
    "pan": "BAACL1234C",
    "gst": "10AABCU9603R1ZM"
  }
}

{
   "error":{
      "code":"BAD_REQUEST_ERROR",
      "description":"Linked account does not exist",
      "source":"",
      "step":"",
      "reason":"linked_account_id_does_not_exist",
      "metadata":{

      }
   }
}

PATCH

accounts

:account_id

curl -X PATCH https://api.razorpay.com/v2/accounts/acc_LWXFUBYnysbYFV \
-u <YOUR_KEY_ID>:<YOUR_KEY_SECRET> \
-H "Content-type: application/json" \
-d '{
  "legal_business_name": "Acme Corp V2",
  "profile": {
    "addresses": {
      "operation": {
        "street1": "5071, Koramangala 6th block",
        "street2": "Kormanagala",
        "city": "Bengaluru",
        "state": "Karnataka",
        "postal_code": 560047,
        "country": "IN"
      }
    }
  },
  "legal_info": {
    "pan": "BAACL1234C",
    "gst": "10AABCU9603R1ZM"
  }
}'

razorpay route accounts update acc_IEIkSOM5VJb2Lm \
  --phone 9000000000 \
  --customer-facing-business-name "Acme New Name" \
  --profile-category healthcare \
  --profile-subcategory diagnostics \
  --support-email newsupport@acme.example.com \
  --pan AAAPL1234C

{
  "id": "acc_LWXFUBYnysbYFV",
  "type": "route",
  "status": "created",
  "email": "gaurava.kumar@example.com",
  "profile": {
    "category": "healthcare",
    "subcategory": "clinic",
    "addresses": {
      "registered": {
        "street1": "507, Koramangala 1st block",
        "street2": "MG Road",
        "city": "Bengaluru",
        "state": "KARNATAKA",
        "postal_code": "560034",
        "country": "IN"
      },
      "operation": {
        "street1": "5071, Koramangala 6th block",
        "street2": "Kormanagala",
        "city": "Bengaluru",
        "state": "KARNATAKA",
        "country": "IN",
        "postal_code": 560047
      }
    }
  },
  "notes": [],
  "created_at": 1679917193,
  "phone": "+919000090000",
  "contact_name": "Gaurav Kumar",
  "reference_id": "124126",
  "business_type": "partnership",
  "legal_business_name": "Acme Corp V2",
  "customer_facing_business_name": "Acme Corp V2",
  "legal_info": {
    "pan": "BAACL1234C",
    "gst": "10AABCU9603R1ZM"
  }
}

{
   "error":{
      "code":"BAD_REQUEST_ERROR",
      "description":"Linked account does not exist",
      "source":"",
      "step":"",
      "reason":"linked_account_id_does_not_exist",
      "metadata":{

      }
   }
}

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

Use this endpoint to update a Linked Account details. You can update all other fields except business_type and email on the created Linked Account.

curl -X PATCH https://api.razorpay.com/v2/accounts/acc_LWXFUBYnysbYFV \
-u <YOUR_KEY_ID>:<YOUR_KEY_SECRET> \
-H "Content-type: application/json" \
-d '{
  "legal_business_name": "Acme Corp V2",
  "profile": {
    "addresses": {
      "operation": {
        "street1": "5071, Koramangala 6th block",
        "street2": "Kormanagala",
        "city": "Bengaluru",
        "state": "Karnataka",
        "postal_code": 560047,
        "country": "IN"
      }
    }
  },
  "legal_info": {
    "pan": "BAACL1234C",
    "gst": "10AABCU9603R1ZM"
  }
}'

razorpay route accounts update acc_IEIkSOM5VJb2Lm \
  --phone 9000000000 \
  --customer-facing-business-name "Acme New Name" \
  --profile-category healthcare \
  --profile-subcategory diagnostics \
  --support-email newsupport@acme.example.com \
  --pan AAAPL1234C

{
  "id": "acc_LWXFUBYnysbYFV",
  "type": "route",
  "status": "created",
  "email": "gaurava.kumar@example.com",
  "profile": {
    "category": "healthcare",
    "subcategory": "clinic",
    "addresses": {
      "registered": {
        "street1": "507, Koramangala 1st block",
        "street2": "MG Road",
        "city": "Bengaluru",
        "state": "KARNATAKA",
        "postal_code": "560034",
        "country": "IN"
      },
      "operation": {
        "street1": "5071, Koramangala 6th block",
        "street2": "Kormanagala",
        "city": "Bengaluru",
        "state": "KARNATAKA",
        "country": "IN",
        "postal_code": 560047
      }
    }
  },
  "notes": [],
  "created_at": 1679917193,
  "phone": "+919000090000",
  "contact_name": "Gaurav Kumar",
  "reference_id": "124126",
  "business_type": "partnership",
  "legal_business_name": "Acme Corp V2",
  "customer_facing_business_name": "Acme Corp V2",
  "legal_info": {
    "pan": "BAACL1234C",
    "gst": "10AABCU9603R1ZM"
  }
}

{
   "error":{
      "code":"BAD_REQUEST_ERROR",
      "description":"Linked account does not exist",
      "source":"",
      "step":"",
      "reason":"linked_account_id_does_not_exist",
      "metadata":{

      }
   }
}

Path Parameters

string

required

Unique identifier of the Linked Account whose details you need to update.

Request Parameters

integer

required

The Linked Account’s business phone number. The minimum length is 8 characters and the maximum length is 15.

string

required

The name of the Linked Account’s business. For example, Acme Corp. The minimum length is 4 characters and the maximum length is 200.

string

The Linked Account billing label as it appears on the Dashboard. The minimum length is 1 character and the maximum length is 255.

string

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

object

required

The business details of the Linked Account’s account.

string

required

The business category of the Linked Account. Possible values: List of Business Categories.

string

required

The business sub-category of the Linked Account. Possible values: List of Business Sub-Categories.

string

The business description. The character limit between 1-255 characters.

object

required

Details of Linked Account’s address.

object

Details of the Linked Account’s operational address.

string

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

string

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

string

The city. The maximum length is 100 characters.

string

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

integer

The postal code. This should be exactly 6 characters.

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.

object

required

Details of the Linked Account’s registered address.

string

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

string

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

string

The city. The maximum length is 100 characters.

string

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

integer

The postal code. This should be exactly 6 characters.

string

object

The legal details about the Linked Account’s business. The mandatory KYC requirement parameters should be passed depending on the business requirements.

string

Valid PAN number details of the Linked Account’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}$/.

string

Valid GSTIN number details of the Linked Account.

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.

object

Options available for contact support.

object

The type of contact support.

string

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

local part (before @): 64 characters.
domain part (after @): 68 characters.
The total character length supported is 132.

integer

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

string

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

object

The type of contact support.

string

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

local part (before @): 64 characters.
domain part (after @): 68 characters.
The total character length supported is 132.

integer

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

string

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

array

The type of contact support.

string

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

local part (before @): 64 characters.
domain part (after @): 68 characters.
The total character length supported is 132.

integer

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

string

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

object

The app details of the account holder’s business

array

The website/app for the account holder’s business. A minimum of 1 website is required.

array

Android app details

string

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

string

The name of the Android app.

array

iOS app details

string

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

string

The name of the iOS app.

Response Parameters

string

The unique identifier of the account generated by Razorpay. The maximum length is 18 characters. For example, acc_GLGeLkU2JUeyDZ.

string

The account type. Possible value is route.

string

The status of the account. Possible values:

created
suspended

string

The account holder’s email address.

integer

The account holder’s phone number. The minimum length is 8 characters and the maximum length is 15.

string

The name of the account holder’s business. For example, Acme Corp. The minimum length is 4 characters and the maximum length is 200.

string

The type of business operated by the account holder. Possible values: Business Types.

object

The account holder’s business details.

string

The business category of the account holder. For example, healthcare. Possible values: Business Category.

string

The business sub-category of the account holder. For example, clinic. Possible values: Business Sub-Category.

object

required

Details of account holder’s address.

object

required

Details of the account holder’s registered address.

string

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

string

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

string

The city. The maximum length is 100 characters.

string

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

integer

The postal code. This should be exactly 6 characters.

string

object

Details of the account holder’s operational address. This parameter might be required to complete the KYC process. However, it is optional for this API.

string

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

string

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

string

The city. The maximum length is 100 characters.

string

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

integer

The postal code. This should be exactly 6 characters.

string

object

The legal details about the account holder’s business. The mandatory KYC requirement parameters should be passed depending on the business requirements.

string

Valid PAN number details of the account holder’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}$/. This parameter might be required to complete the KYC process. However, it is optional for this API.

string

Valid GSTIN number details of the account holder.

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.

object

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

string

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

object

Options available for contact support.

Errors

Linked account does not exist.

Code: 400This error occurs when the requester is not the parent of the child account, or the child account does not exist.Solution: Ensure the Linked Account id exists before proceeding with the update API.

Merchant activation form has been locked for editing by admin.

Code: 400This error occurs when the submitted extra fields are under the review stage.Solution: You can wait for the review to be successful.

Last modified on October 8, 2026

​Path Parameters

​Request Parameters

​Response Parameters

​Errors

Path Parameters

Request Parameters

Response Parameters

Errors