API Test Keys

Upload Stakeholder Documents

POST

/v2/accounts/:account_id/stakeholders/:stakeholder_id/documents

Click to copy

Use this endpoint to upload signatory documents for a stakeholder. Know about the

various error responses

for this API.

Handy Tips

If your product activation status is requested, you can update all the fields. If the status is needs_clarification, you can update only specific fields.

Is this page helpful?

Curl

change language

1curl -u <ACCESS_TOKEN> \
2-X POST https://api.razorpay.com/v2/accounts/acc_Go5TSvGPw0NB8v/stakeholders/sth_Go5iFZJ8dqAfjg/documents \
3-F 'file=@/Users/your_name/Downloads/sample_uploaded.jpeg' // file path
4-F 'document_type=aadhar_front'

Success

1{
2  "individual_proof_of_address": [
3    {
4      "type": "aadhar_front",
5      "url": "https://rzp.io/i/bzDAbNg"
6    }
7  ]
8}

Path Parameters

account_id

string

The unique identifier of a sub-merchant account generated by Razorpay. For example, acc_GMh5YcLv9iGMKf.

stakeholder_id

string

The unique identifier of the stakeholder generated by Razorpay. For example, sth_GOUCFN3nE0XlYq.

Request Parameters

file

array

The URL generated once the business proof document is uploaded.

document_type

string

The documents for the valid 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 Parameters

individual_proof_of_address

array

The document submitted as individual proof of address.

Show child parameters (2)

Upload Stakeholder Documents

POST

/v2/accounts/:account_id/stakeholders/:stakeholder_id/documents

Click to copy

Use this endpoint to upload signatory documents for a stakeholder. Know about the

various error responses

for this API.

Handy Tips

If your product activation status is requested, you can update all the fields. If the status is needs_clarification, you can update only specific fields.

Is this page helpful?

Path Parameters

account_id

string

The unique identifier of a sub-merchant account generated by Razorpay. For example, acc_GMh5YcLv9iGMKf.

stakeholder_id

string

The unique identifier of the stakeholder generated by Razorpay. For example, sth_GOUCFN3nE0XlYq.

Request Parameters

file

array

The URL generated once the business proof document is uploaded.

document_type

string

The documents for the valid 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 Parameters

individual_proof_of_address

array

The document submitted as individual proof of address.

Show child parameters (2)

Curl

change language

1curl -u <ACCESS_TOKEN> \
2-X POST https://api.razorpay.com/v2/accounts/acc_Go5TSvGPw0NB8v/stakeholders/sth_Go5iFZJ8dqAfjg/documents \
3-F 'file=@/Users/your_name/Downloads/sample_uploaded.jpeg' // file path
4-F 'document_type=aadhar_front'

Success

1{
2  "individual_proof_of_address": [
3    {
4      "type": "aadhar_front",
5      "url": "https://rzp.io/i/bzDAbNg"
6    }
7  ]
8}