| Server IP : 66.29.137.217 / Your IP : 3.141.33.133 Web Server : LiteSpeed System : Linux premium294.web-hosting.com 4.18.0-513.11.1.lve.el8.x86_64 #1 SMP Thu Jan 18 16:21:02 UTC 2024 x86_64 User : gltevjme ( 1095) PHP Version : 7.0.33 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : OFF | Pkexec : OFF Directory : /home/gltevjme/bofirm.gltechlimited.com/vendor/razorpay/razorpay/documents/ |
Upload File : |
## Stakeholders
### Create an Stakeholder
```php
$accountId = "acc_GP4lfNA0iIMn5B";
$api->account->fetch("acc_GP4lfNA0iIMn5B")->stakeholders()->create(array(
"percentage_ownership" => 10,
"name" => "Gaurav Kumar",
"email" => "gaurav.kumar@example.com",
"relationship" => array(
"director" => true,
"executive" => false
),
"phone" => array(
"primary" => "7474747474",
"secondary" => "7474747474"
),
"addresses" => array(
"residential" => array(
"street" => "506, Koramangala 1st block",
"city" => "Bengaluru",
"state" => "Karnataka",
"postal_code" => "560034",
"country" => "IN"
)
),
"kyc" => array(
"pan" => "AVOPB1111K"
),
"notes" => array(
"random_key_by_partner" => "random_value"
)
));
```
**Parameters:**
| Name | Type | Description |
|---------------|-------------|---------------------------------------------|
| email | string | The sub-merchant's business email address. |
| name* | string | The stakeholder's name as per the PAN card. The maximum length is 255 characters. |
| percentage_ownership | float | The stakeholder's ownership of the business in percentage. Only two decimal places are allowed. For example, `87.55`. The maximum length is 100 characters. |
| relationship | boolean | The stakeholder's relationship with the account’s business. |
| phone | object | All keys listed [here](https://razorpay.com/docs/api/partners/stakeholder/#create-a-stakeholder) are supported |
| addresses | object | All keys listed [here](https://razorpay.com/docs/api/partners/stakeholder/#create-a-stakeholder) are supported |
| kyc | object | All keys listed [here](https://razorpay.com/docs/api/partners/stakeholder/#create-a-stakeholder) are supported |
| notes | object | A key-value pair |
**Response:**
```json
{
"entity": "stakeholder",
"relationship": {
"director": true
},
"phone": {
"primary": "7474747474",
"secondary": "7474747474"
},
"notes": {
"random_key_by_partner": "random_value"
},
"kyc": {
"pan": "AVOPB1111K"
},
"id": "sth_GLGgm8fFCKc92m",
"name": "Gaurav Kumar",
"email": "gaurav.kumar@example.com",
"percentage_ownership": 10,
"addresses": {
"residential": {
"street": "506, Koramangala 1st block",
"city": "Bengaluru",
"state": "Karnataka",
"postal_code": "560034",
"country": "IN"
}
}
}
```
-------------------------------------------------------------------------------------------------------
### Edit Stakeholder
```php
$accountId = "acc_GP4lfNA0iIMn5B";
$stakeholderId = "sth_GOQ4Eftlz62TSL";
$api->account->fetch($accountId)->stakeholders()->edit($stakeholderId, array(
"percentage_ownership" => 20,
"name" => "Gauri Kumar",
"relationship" => array(
"director" => false,
"executive" => true
),
"phone" => array(
"primary" => "9898989898",
"secondary" => "9898989898"
),
"addresses" => array(
"residential" => array(
"street" => "507, Koramangala 1st block",
"city" => "Bangalore",
"state" => "Karnataka",
"postal_code" => "560035",
"country" => "IN"
)
),
"kyc" => array(
"pan" => "AVOPB1111J"
),
"notes" => array(
"random_key_by_partner" => "random_value2"
)
));
```
**Parameters:**
| Name | Type | Description |
|---------------|-------------|---------------------------------------------|
| accountId* | string | The unique identifier of a sub-merchant account generated by Razorpay. |
| stakeholderId* | string | The unique identifier of the stakeholder whose details are to be fetched. |
| name | string | The stakeholder's name as per the PAN card. The maximum length is 255 characters. |
| percentage_ownership | float | The stakeholder's ownership of the business in percentage. Only two decimal places are allowed. For example, `87.55`. The maximum length is 100 characters. |
| relationship | boolean | The stakeholder's relationship with the account’s business. |
| phone | object | All keys listed [here](https://razorpay.com/docs/api/partners/stakeholder/#update-a-stakeholder) are supported |
| addresses | object | All keys listed [here](https://razorpay.com/docs/api/partners/stakeholder/#update-a-stakeholder) are supported |
| kyc | object | All keys listed [here](https://razorpay.com/docs/api/partners/stakeholder/#update-a-stakeholder) are supported |
| notes | object | A key-value pair |
**Response:**
```json
{
"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"
}
```
-------------------------------------------------------------------------------------------------------
### Fetch all accounts
```php
$accountId = "acc_GP4lfNA0iIMn5B";
$api->account->fetch($accountId)->stakeholders()->all();
```
**Parameters:**
| Name | Type | Description |
|---------------|-------------|---------------------------------------------|
| accountId* | string | The unique identifier of a sub-merchant account generated by Razorpay. |
**Response:**
```json
{
"entity": "collection",
"items": [
{
"id": "GZ13yPHLJof9IE",
"entity": "stakeholder",
"relationship": {
"director": true
},
"phone": {
"primary": "9000090000",
"secondary": "9000090000"
},
"notes": {
"random_key_by_partner": "random_value"
},
"kyc": {
"pan": "AVOPB1111K"
},
"name": "Gaurav Kumar",
"email": "gaurav.kumar@acme.org",
"percentage_ownership": 10,
"addresses": {
"residential": {
"street": "506, Koramangala 1st block",
"city": "Bengaluru",
"state": "Karnataka",
"postal_code": "560034",
"country": "in"
}
}
}
],
"count": 1
}
```
-------------------------------------------------------------------------------------------------------
### Fetch an stakeholder
```php
$accountId = "acc_GP4lfNA0iIMn5B";
$stakeholderId = "sth_GOQ4Eftlz62TSL";
$api->account->fetch($accountId)->stakeholders()->fetch($stakeholderId);
```
**Parameters:**
| Name | Type | Description |
|-------------|-------------|---------------------------------------------|
| accountId* | string | The unique identifier of a sub-merchant account generated by Razorpay. |
| stakeholderId* | string | The unique identifier of the stakeholder whose details are to be fetched. |
**Response:**
```json
{
"entity": "stakeholder",
"relationship": {
"director": true
},
"phone": {
"primary": "9000090000",
"secondary": "9000090000"
},
"notes": {
"random_key_by_partner": "random_value2"
},
"kyc": {
"pan": "AVOPB1111J"
},
"id": "sth_GOQ4Eftlz62TSL",
"name": "Gauri Kumar",
"email": "gauri@example.com",
"percentage_ownership": 20,
"addresses": {
"residential": {
"street": "507, Koramangala 1st block",
"city": "Bangalore",
"state": "Karnataka",
"postal_code": "560035",
"country": "in"
}
}
}
```
-------------------------------------------------------------------------------------------------------
**PN: * indicates mandatory fields**
<br>
<br>
**For reference click [here](https://razorpay.com/docs/api/partners/stakeholder)**