Skip to main content
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.

​
Request

Curl

​
Response

Success

​
Parameters

account_id mandatory : string Unique identifier of the Linked Account whose details you need to update.

​
Parameters

phonemandatory : integer The Linked Account’s business phone number. The minimum length is 8 characters and the maximum length is 15. legal_business_name mandatory : string The name of the Linked Account’s business. For example, Acme Corp. The minimum length is 4 characters and the maximum length is 200. customer_facing_business_name optional : string The Linked Account billing label as it appears on the Dashboard. The minimum length is 1 character and the maximum length is 255. reference_id optional : string Partner’s external account reference id. The minimum length is 1 character and the maximum length is 512. profile mandatory : object The business details of the Linked Account’s account. category mandatory : string The business category of the Linked Account. Possible values: List of Business Categories. subcategory mandatory : string The business sub-category of the Linked Account. Possible values: List of Business Sub-Categories. business_model optional : string The business description. The character limit between 1-255 characters. addresses : object Details of Linked Account’s address. operation optional : object Details of the Linked Account’s operational 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 32. 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. registered mandatory : object Details of the Linked Account’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 32. 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. legal_info conditional : object The legal details about the Linked Account’s business. The mandatory KYC requirement parameters should be passed depending on the business requirements. pan conditional : 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}$/.
gst conditional : 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.
contact_info optional : 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. 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://“:port/resource path?querystring#fragementid) 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. 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://“:port/resource path?querystring#fragementid) 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. 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://“:port/resource path?querystring#fragementid) protocol-both http/https allowed. apps optional : object The app details of the account holder’s business websites : array The website/app for the account holder’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://“:port/resource path?querystring#fragementid) 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://“:port/resource path?querystring#fragementid) protocol-both http/https allowed. name : string The name of the iOS app.

​
Parameters

id : string The unique identifier of the account generated by Razorpay. The maximum length is 18 characters. For example, acc_GLGeLkU2JUeyDZ. type : string The account type. Possible value is route. status : string The status of the account. Possible values:
  • created
  • suspended
email : string The account holder’s email address. phone : integer The account holder’s phone number. The minimum length is 8 characters and the maximum length is 15. legal_business_name : 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. business_type : string The type of business operated by the account holder. Possible values: Business Types. profile : object The account holder’s business details. category : string The business category of the account holder. For example, healthcare. Possible values: Business Category. subcategory : string The business sub-category of the account holder. For example, clinic. Possible values: Business Sub-Category. addresses : object Details of account holder’s address. registered : object Details of the account holder’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. operation : 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. 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. legal_info : object The legal details about the account holder’s business. The mandatory KYC requirement parameters should be passed depending on the business requirements. pan : 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.
gst : 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.
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.

​
Errors

Linked account does not exist.
  • code: 400
  • description: This 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: 400
  • description: This error occurs when the submitted extra fields are under the review stage.
  • solution: You can wait for the review to be successful.