Introduction

API Reference Guide

API Changelog

Understand Razorpay APIs

Authentication

Sandbox Setup

Best Practices

Glossary

Payments

Orders

Payments

Downtime

Settlements

Instant Settlements

Refunds

Disputes

Documents

Customers

Payment Links

QR Codes

Invoices

Subscriptions

Route

Smart Collect

TPAP Pro

Customer Onboarding

Accounts Management

Payments

Mandates Flow

Bills

About Bills

Bills Entity

Create a Bill

Update a Bill

Delete a Bill

Partners

Account

Product Configuration

Stakeholder

Documents

Webhooks

Payout APIs

Get Started

Account Validation

Fetch Balance

Composite Account Validation

Contacts

Fund Accounts

Payouts

Payouts to Cards

Payout Composite

Payouts Approval

Payout Idempotency

Payout Links

Payout Wallet - Amazon

Transactions

Api

Payments

Route

Update Stakeholder

API Test Keys

Update a Stakeholder Account

PATCH
/v2/accounts/:account_id/stakeholders/:stakeholder_id

Click to copy

Use this endpoint to update a stakeholder account.

Is this page helpful?

Curl

1
curl -X POST 'https://api.razorpay.com/v2/accounts/acc_GLGeLkU2JUeyDZ/stakeholders' \
2
     -u [YOUR_KEY_ID]:[YOUR_SECRET] \
3
     -H "Content-type: application/json" \
4
     -d '{
5
  "name": " Nur Aisyah",
6
  "email": "nur.aisyah@example.com",
7
  "addresses": {
8
    "residential": {
9
      "street": "506 bacca street",
10
      "city": "Malacca",
11
      "state": "Malacca",
12
      "postal_code": "43200",
13
      "country": "MY"
14
    }
15
  },
16
  "notes": {
17
    "random_key": "random_value"
18
  }
19
}'

Success

Failure

1
{
2
  "id": "sth_QS6ty4jRc99fx6",
3
  "entity": "stakeholder",
4
  "relationship": [],
5
  "phone": [],
6
  "notes": {
7
    "random_key": "random_value"
8
  },
9
  "kyc": [],
10
  "name": " Nur Aisyah",
11
  "email": "nur.aisyah@example.com",
12
  "addresses": {
13
    "residential": {
14
      "street": "506 bacca street",
15
      "city": "Malacca",
16
      "state": "Malacca",
17
      "postal_code": "43200",
18
      "country": "MY"
19
    }
20
  }
21
}
Path Parameters
account_id
string

The unique identifier of the account generated by Razorpay. For example, acc_GLGeLkU2JUeyDZ. This id is used to fetch or update a stakeholder.

stakeholder_id
string

The unique of the stakeholder account created. For example, sth_GOQ4Eftlz62TSL.

Request Parameters
name

*

string

The stakeholder's name as per the PAN card. The maximum length is 255 characters.

email

*

string

The stakeholder's email address. The maximum length is:

  • local part (before @): 64 characters.
  • domain part (after @): 68 characters.
    The total character length supported is 132.

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
object

The stakeholder's relationship with the account's business. director : boolean Determines if stakeholder is a director of the account's legal entity.

  • true: Stakeholder is a director.
  • false (default): Stakeholder is not a director. executive : boolean Determines if the stakeholder is an executive of the account's legal entity.
  • true: Stakeholder is an executive.
  • false (false): Stakeholder is not an executive.

phone
object

The stakeholder's phone number.

Show child parameters (2)

addresses
object

Details of stakeholder's address.

Show child parameters (1)

kyc
object

The type of document required to establish the stakeholder's identity.

notes
object

Contains user-defined fields stored for reference purposes. Maximum 15 key-value pairs, 512 characters (maximum) each.

Response Parameters
id
string

The unique identifier of a stakeholder generated by Razorpay, used to fetch or update a stakeholder. For example, sth_GLGgm8fFCKc92m. Maximum length supported is 18 characters.

entity
string

Here it is stakeholder.

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.

name
string

The stakeholder's name as per the PAN card. The maximum length is 255 characters.

email
string

The stakeholder's email address. The maximum length is:

  • local part (before @): 64 characters.
  • domain part (after @): 68 characters.

relationship
object

The stakeholder's relationship with the account's business. director : boolean Determines if stakeholder is a director of the account's legal entity.

  • true: Stakeholder is a director.
  • false (default): Stakeholder is not a director. executive : boolean Determines if the stakeholder is an executive of the account's legal entity.
  • true: Stakeholder is an executive.
  • false (false): Stakeholder is not an executive.

phone
object

The stakeholder's phone number.

Show child parameters (2)

addresses
object

Details of stakeholder's address.

Show child parameters (1)

kyc
object

The type of document required to establish the stakeholder's identity.

notes
object

Contains user-defined fields stored by the partner for reference purposes. It can hold a maximum of 15 key-value pairs, 512 characters (maximum) each. For example, "note_key": "Beam me up Scotty”.

Errors

Linked account does not exist.

Error Status: 400

This error occurs when the requester is not the parent of the child account, or the child account does not exist.

Solution

The id provided does not exist.

Error Status: 400

This error occurs when the stakeholder does not belong to the account provided.

Solution

Merchant activation form has been locked for editing by admin.

Error Status: 400

This error occurs when the submitted extra fields are under the review stage.

Solution

Update a Stakeholder Account

PATCH
/v2/accounts/:account_id/stakeholders/:stakeholder_id

Click to copy

Use this endpoint to update a stakeholder account.

Is this page helpful?

Path Parameters
account_id
string

The unique identifier of the account generated by Razorpay. For example, acc_GLGeLkU2JUeyDZ. This id is used to fetch or update a stakeholder.

stakeholder_id
string

The unique of the stakeholder account created. For example, sth_GOQ4Eftlz62TSL.

Request Parameters
name

*

string

The stakeholder's name as per the PAN card. The maximum length is 255 characters.

email

*

string

The stakeholder's email address. The maximum length is:

  • local part (before @): 64 characters.
  • domain part (after @): 68 characters.
    The total character length supported is 132.

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
object

The stakeholder's relationship with the account's business. director : boolean Determines if stakeholder is a director of the account's legal entity.

  • true: Stakeholder is a director.
  • false (default): Stakeholder is not a director. executive : boolean Determines if the stakeholder is an executive of the account's legal entity.
  • true: Stakeholder is an executive.
  • false (false): Stakeholder is not an executive.

phone
object

The stakeholder's phone number.

Show child parameters (2)

addresses
object

Details of stakeholder's address.

Show child parameters (1)

kyc
object

The type of document required to establish the stakeholder's identity.

notes
object

Contains user-defined fields stored for reference purposes. Maximum 15 key-value pairs, 512 characters (maximum) each.

Response Parameters
id
string

The unique identifier of a stakeholder generated by Razorpay, used to fetch or update a stakeholder. For example, sth_GLGgm8fFCKc92m. Maximum length supported is 18 characters.

entity
string

Here it is stakeholder.

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.

name
string

The stakeholder's name as per the PAN card. The maximum length is 255 characters.

email
string

The stakeholder's email address. The maximum length is:

  • local part (before @): 64 characters.
  • domain part (after @): 68 characters.

relationship
object

The stakeholder's relationship with the account's business. director : boolean Determines if stakeholder is a director of the account's legal entity.

  • true: Stakeholder is a director.
  • false (default): Stakeholder is not a director. executive : boolean Determines if the stakeholder is an executive of the account's legal entity.
  • true: Stakeholder is an executive.
  • false (false): Stakeholder is not an executive.

phone
object

The stakeholder's phone number.

Show child parameters (2)

addresses
object

Details of stakeholder's address.

Show child parameters (1)

kyc
object

The type of document required to establish the stakeholder's identity.

notes
object

Contains user-defined fields stored by the partner for reference purposes. It can hold a maximum of 15 key-value pairs, 512 characters (maximum) each. For example, "note_key": "Beam me up Scotty”.

Errors

Linked account does not exist.

Error Status: 400

This error occurs when the requester is not the parent of the child account, or the child account does not exist.

Solution

The id provided does not exist.

Error Status: 400

This error occurs when the stakeholder does not belong to the account provided.

Solution

Merchant activation form has been locked for editing by admin.

Error Status: 400

This error occurs when the submitted extra fields are under the review stage.

Solution

Curl

1
curl -X POST 'https://api.razorpay.com/v2/accounts/acc_GLGeLkU2JUeyDZ/stakeholders' \
2
     -u [YOUR_KEY_ID]:[YOUR_SECRET] \
3
     -H "Content-type: application/json" \
4
     -d '{
5
  "name": " Nur Aisyah",
6
  "email": "nur.aisyah@example.com",
7
  "addresses": {
8
    "residential": {
9
      "street": "506 bacca street",
10
      "city": "Malacca",
11
      "state": "Malacca",
12
      "postal_code": "43200",
13
      "country": "MY"
14
    }
15
  },
16
  "notes": {
17
    "random_key": "random_value"
18
  }
19
}'

Success

Failure

1
{
2
  "id": "sth_QS6ty4jRc99fx6",
3
  "entity": "stakeholder",
4
  "relationship": [],
5
  "phone": [],
6
  "notes": {
7
    "random_key": "random_value"
8
  },
9
  "kyc": [],
10
  "name": " Nur Aisyah",
11
  "email": "nur.aisyah@example.com",
12
  "addresses": {
13
    "residential": {
14
      "street": "506 bacca street",
15
      "city": "Malacca",
16
      "state": "Malacca",
17
      "postal_code": "43200",
18
      "country": "MY"
19
    }
20
  }
21
}