Skip to content

Latest commit

 

History

History
345 lines (300 loc) · 10.5 KB

stakeholder.md

File metadata and controls

345 lines (300 loc) · 10.5 KB

Stakeholders

Create an Stakeholder

$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 are supported
addresses object All keys listed here are supported
kyc object All keys listed here are supported
notes object A key-value pair

Response:

{
  "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

$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 are supported
addresses object All keys listed here are supported
kyc object All keys listed here are supported
notes object A key-value pair

Response:

{
  "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

$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:

{
  "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

$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:

{
  "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"
    }
  }
}

Upload stakeholders documents

$accountId = "acc_00000000000001";

$stakeholderId = "sth_00000000000001";

$payload = [
    'file'=> '/Users/your_name/Downloads/sample_uploaded.pdf',
    "document_type" => "aadhar_front"
];

$api->account->fetch($accountId)->stakeholders()->uploadStakeholderDoc($stakeholderId, $payload);

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.
file* string The URL generated once the business proof document is uploaded.
document_type* string The documents valid for the proof type to be shared. In case of individual_proof_of_address, both the front and back of a document proof must be uploaded. Possible values :
individual_proof_of_identification: personal_pan

individual_proof_of_address : voter_id_back, voter_id_front, aadhar_front, aadhar_back, passport_front, passport_back

Response:

{
  "individual_proof_of_address": [
    {
      "type": "aadhar_front",
      "url": "https://rzp.io/i/bzDAbNg"
    }
  ]
}

Fetch stakeholders documents

$accountId = "acc_00000000000001";

$stakeholderId = "sth_00000000000001";

$api->account->fetch($accountId)->stakeholders()->fetchStakeholderDoc($stakeholderId);

Parameters:

Name Type Description
accountId* string The unique identifier of a sub-merchant account generated by Razorpay.

Response:

{
  "business_proof_of_identification": [
    {
      "type": "business_proof_url",
      "url": "<https://rzp.io/i/bzDKbNg>"
    }
  ]
}

PN: * indicates mandatory fields

For reference click here

$result = $api->account->fetch("acc_M83Uw27KXuC7c8")->stakeholders()->fetchStakeholderDoc("sth_M83WuwmrCFa55g", $payload);

$result = $api->account->fetch("acc_M83Uw27KXuC7c8")->stakeholders()->uploadStakeholderDoc("sth_M83WuwmrCFa55g", $payload);