RArazorpay
Linked Accounts

Create a Linked Account

Create a sub-merchant (Linked Account) under a Route marketplace. The account type must be 'route'. Email and business_type cannot be changed after creation. Only one stakeholder is allowed per Linked Account.

post/v2/accounts

Request

Request body

emailstring required

Contact email. Cannot be changed after creation.

phonestring

Phone number with country code.

legal_business_namestring
business_type'route'

Cannot be changed after creation.

type'route' required
notesNotes

Key-value pairs for storing custom metadata. Maximum 15 pairs. Each key and value must not exceed 256 characters.

Response

Linked Account created.

idstring

Account ID. Prefix: acc_

type'route'

Account type. Always 'route' for Route marketplace accounts.

status'created' | 'suspended'

Account status.

emailstring

Contact email. Cannot be updated after creation.

phonestring

Contact phone number with country code (e.g., +919876543210).

legal_business_namestring

Registered legal name of the business.

business_type'route'

Business type. Cannot be updated after creation.

contact_namestring

Name of the primary contact person.

notesNotes

Key-value pairs for storing custom metadata. Maximum 15 pairs. Each key and value must not exceed 256 characters.

created_atinteger

Changes

No recorded changes to this operation across all 1 revision of this API.