Editing: linkedAccount.md
## Linked Account ### Create Linked Accounts for Sub-Merchants and Others ```php $api->setHeader('X-Razorpay-Account', 'acc_sub-merchantId'); $api->account->create(array( "email" => "gauriagain.kumar@example.org", "phone" => "9999999999", "type" => "route", "reference_id" => "124124", "legal_business_name" => "Acme Corp", "business_type" => "partnership", "contact_name" => "Gaurav Kumar", "profile" => array( "category" => "healthcare", "subcategory" => "clinic", "addresses" => array( "registered" => array( "street1" => "507, Koramangala 1st block", "street2" => "MG Road", "city" => "Bengaluru", "state" => "Karnataka", "postal_code" => 560034, "country" => "IN" ) ), ), "legal_info" => array( "pan" => "AAACL1234C", "gst" => "18AABCU9603R1ZM" ), )); ``` **Parameters:** | Name | Type | Description | |---------------|-------------|---------------------------------------------| | 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 Razorpay Dashboard. The minimum length is 1 character and the maximum length is 255. | | business_type* | string | The type of business operated by the sub-merchant.Possible value is `proprietorship`, `partnership`, `private_limited`, `public_limited`, `llp`, `ngo`, `trust`, `society`, `not_yet_registered`, `huf` | | reference_id | string | Partner's external account reference id. The minimum length is 1 character and the maximum length is 512. | | profile | object | All keys listed [here](https://razorpay.com/docs/partners/route/linked-accounts/#create-linked-accounts-for-sub-merchants-and-others) are supported | | legal_info | object | All keys listed [here](https://razorpay.com/docs/partners/route/linked-accounts/#create-linked-accounts-for-sub-merchants-and-others) are supported | | contact_info | object | All keys listed [here](https://razorpay.com/docs/api/partners/account-onboarding/#create-an-account) are supported | | apps | object | All keys listed [here](https://razorpay.com/docs/api/partners/account-onboarding/#create-an-account) are supported | **Response:** ```json { "id":"acc_GRWKk7qQsLnDjX", "type":"route", "status":"created", "email":"gaurav.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" } } }, "notes":[ ], "created_at":1611136837, "phone":"9999999999", "contact_name":"Gaurav Kumar", "reference_id":"124124", "business_type":"partnership", "legal_business_name":"Acme Corp", "customer_facing_business_name":"Acme Corp", "legal_info":{ "pan":"AAACL1234C", "gst":"18AABCU9603R1ZM" } } ``` ------------------------------------------------------------------------------------------------------- ### Fetch a Linked Account of a Sub-Merchant by id ```php $api->setHeader('X-Razorpay-Account', 'acc_sub-merchantId'); $accountId = "acc_GP4lfNA0iIMn5B"; $api->account->fetch($accountId); ``` **Parameters:** | Name | Type | Description | |-------------|-------------|---------------------------------------------| | accountId* | string | The unique identifier of a sub-merchant account generated by Razorpay. | **Response:** ```json { "id":"acc_GLGeLkU2JUeyDZ", "type":"route", "reference_id":"123123", "status":"created", "email":"gaurav.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":"507, Koramangala 6th block", "street2":"Kormanagala", "city":"Bengaluru", "state":"KARNATAKA", "country":"IN", "postal_code":560047 } }, "business_model":null }, "notes":[ ], "created_at":1611136837, "phone":"9999999998", "business_type":"partnership", "legal_business_name":"Acme Corp", "customer_facing_business_name":"Acme Corp", "legal_info":{ "pan":"AAACL1234C", "gst":"18AABCU9603R1ZM" }, "apps":{ "websites":[ ], "android":[ { "url":null, "name":null } ], "ios":[ { "url":null, "name":null } ] }, "brand":{ "color":null }, "contact_name":"Gaurav Kumar", "contact_info":{ "chargeback":{ "email":null, "phone":null, "policy_url":null }, "refund":{ "email":null, "phone":null, "policy_url":null }, "support":{ "email":null, "phone":null, "policy_url":null } } } ``` ------------------------------------------------------------------------------------------------------- **PN: * indicates mandatory fields** <br> <br> **For reference click [here](https://razorpay.com/docs/partners/route/linked-accounts)**
Save
Back