Upload Stakeholder Documents

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

RazorpayClient razorpay = new RazorpayClient("[ACCESS_TOKEN]");

String accoundId = "acc_LryDIBIjBDbOWy";
String stakeholderId = "sth_M0zjeiVOLRJRPW";

JSONObject request = new JSONObject();
request.put("file","/Users/your_name/Downloads/sample_uploaded.jpeg");
request.put("document_type","aadhar_front");

Stakeholder stakeholder = instance.stakeholder.uploadStakeholderDoc(accoundId, stakeholderId, request);

$api = new Api(null, null, "<ACCESS_TOKEN>");

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

$stakeholders = $api->account->fetch($accountId)->stakeholders();

$stakeholders->uploadStakeholderDoc($stakeholderId, $payload);

const instance = new Razorpay({
  oauthToken: "<ACCESS_TOKEN>",
});

const accountId = "acc_GP4lfNA0iIMn5B";
const stakeholderId = "sth_GOQ4Eftlz62TSL";

const uploadFile = fs.createReadStream(
  "/Users/your_name/Downloads/sample_uploaded.jpeg",
);

const formData = {
  file: {
    value: uploadFile,
    options: {
      filename: "sample_uploaded.jpeg",
      contentType: null,
    },
  },
  document_type: "aadhar_front",
};

instance.stakeholders.uploadStakeholderDoc(accountId, stakeholderId, formData);

require "razorpay"
Razorpay.setup('ACCESS_TOKEN')
account_id = "acc_0000000000001"
stakeholder_id = "sth_00000000000001"

Razorpay::Stakeholder.upload_stakeholder_doc(account_id, stakeholder_id, {
  "file": File.new("/Users/your_name/Downloads/sample_uploaded.jpeg"),
  "document_type": "aadhar_front"
});

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

POST

accounts

:account_id

stakeholders

:stakeholder_id

documents

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

RazorpayClient razorpay = new RazorpayClient("[ACCESS_TOKEN]");

String accoundId = "acc_LryDIBIjBDbOWy";
String stakeholderId = "sth_M0zjeiVOLRJRPW";

JSONObject request = new JSONObject();
request.put("file","/Users/your_name/Downloads/sample_uploaded.jpeg");
request.put("document_type","aadhar_front");

Stakeholder stakeholder = instance.stakeholder.uploadStakeholderDoc(accoundId, stakeholderId, request);

$api = new Api(null, null, "<ACCESS_TOKEN>");

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

$stakeholders = $api->account->fetch($accountId)->stakeholders();

$stakeholders->uploadStakeholderDoc($stakeholderId, $payload);

const instance = new Razorpay({
  oauthToken: "<ACCESS_TOKEN>",
});

const accountId = "acc_GP4lfNA0iIMn5B";
const stakeholderId = "sth_GOQ4Eftlz62TSL";

const uploadFile = fs.createReadStream(
  "/Users/your_name/Downloads/sample_uploaded.jpeg",
);

const formData = {
  file: {
    value: uploadFile,
    options: {
      filename: "sample_uploaded.jpeg",
      contentType: null,
    },
  },
  document_type: "aadhar_front",
};

instance.stakeholders.uploadStakeholderDoc(accountId, stakeholderId, formData);

require "razorpay"
Razorpay.setup('ACCESS_TOKEN')
account_id = "acc_0000000000001"
stakeholder_id = "sth_00000000000001"

Razorpay::Stakeholder.upload_stakeholder_doc(account_id, stakeholder_id, {
  "file": File.new("/Users/your_name/Downloads/sample_uploaded.jpeg"),
  "document_type": "aadhar_front"
});

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

Use this endpoint to upload signatory documents for a stakeholder. Know about the various error responses for this API.

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

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

RazorpayClient razorpay = new RazorpayClient("[ACCESS_TOKEN]");

String accoundId = "acc_LryDIBIjBDbOWy";
String stakeholderId = "sth_M0zjeiVOLRJRPW";

JSONObject request = new JSONObject();
request.put("file","/Users/your_name/Downloads/sample_uploaded.jpeg");
request.put("document_type","aadhar_front");

Stakeholder stakeholder = instance.stakeholder.uploadStakeholderDoc(accoundId, stakeholderId, request);

$api = new Api(null, null, "<ACCESS_TOKEN>");

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

$stakeholders = $api->account->fetch($accountId)->stakeholders();

$stakeholders->uploadStakeholderDoc($stakeholderId, $payload);

const instance = new Razorpay({
  oauthToken: "<ACCESS_TOKEN>",
});

const accountId = "acc_GP4lfNA0iIMn5B";
const stakeholderId = "sth_GOQ4Eftlz62TSL";

const uploadFile = fs.createReadStream(
  "/Users/your_name/Downloads/sample_uploaded.jpeg",
);

const formData = {
  file: {
    value: uploadFile,
    options: {
      filename: "sample_uploaded.jpeg",
      contentType: null,
    },
  },
  document_type: "aadhar_front",
};

instance.stakeholders.uploadStakeholderDoc(accountId, stakeholderId, formData);

require "razorpay"
Razorpay.setup('ACCESS_TOKEN')
account_id = "acc_0000000000001"
stakeholder_id = "sth_00000000000001"

Razorpay::Stakeholder.upload_stakeholder_doc(account_id, stakeholder_id, {
  "file": File.new("/Users/your_name/Downloads/sample_uploaded.jpeg"),
  "document_type": "aadhar_front"
});

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

Path Parameters

string

required

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

string

required

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

Request Parameters

array

required

The URL generated once the business proof document is uploaded.

string

required

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

array

The document submitted as individual proof of address.

string

The type of document. Possible values:

voter_id_back
voter_id_front
aadhar_front
aadhar_back
passport_front
passport_back

string

The URL of the document.

Partners

Payout APIs

Upload Stakeholder Documents

Path Parameters

Request Parameters

Response Parameters

​Path Parameters

​Request Parameters

​Response Parameters

Path Parameters

Request Parameters

Response Parameters