put
https://test-accounts.payu.in/api/v1/merchants//signatory_details
The Add Signatory Details API submits the authorised signatory for the merchant agreement (Step 08 of 16).
Notes:
- Prerequisite: Step 07 (website details).
- Entity applicability: All entities.
- This step is mandatory before DigiLocker (Step 09). CIN in signatory details applies only to CIN-eligible entities (Pvt Ltd, Public Limited, OPC).
HTTP Method: PUT
Environment
| URL | |
|---|---|
| Test Environment | https://test-partner.payu.in/api/v1/merchants/{uuid}/signatory_details |
| Production Environment | https://partner.payu.in/api/v1/merchants/{uuid}/signatory_details |
Note: DigiLocker (Step 09) and VKYC (Step 11) fail if signatory details are missing. Complete this step before those APIs.
Sample Request
Sample request
curl --location --request PUT 'https://test-partner.payu.in/api/v1/merchants/{{uuid}}/signatory_details' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'merchant[signatory_contact_details_attributes[0][authorised_signatory]]=true' \
--data-urlencode 'merchant[signatory_contact_details_attributes[0][name]]=Signatory 1 Name' \
--data-urlencode 'merchant[signatory_contact_details_attributes[0][pancard_number]]=ABCDE1234F' \
--data-urlencode 'merchant[signatory_contact_details_attributes[0][email]][email protected]' \
--data-urlencode 'merchant[signatory_contact_details_attributes[0][contact_detail_type]]=Signing Authority' \
--data-urlencode 'merchant[signatory_contact_details_attributes[0][cin_number]]='Sample Response
Success scenario
Success scenario
{
"merchant": {
"mid": 12345678,
"status": "account_created"
}
}Failure scenario
Failure scenario
- 401 Unauthorized — Token invalid or expired; call Step 00 again
{
"error": "unauthorized",
"message": "Invalid or expired token"
}- 422 Validation Failed — Request parameters failed validation
{
"error": "validation_failed",
"message": "Check the error details in the response body"
}Response parameters
Response parameters
| Parameter | Description | Example |
|---|---|---|
| merchant.mid | integer — Merchant ID | 12345678 |
| merchant.status | string — Current onboarding status | account_created |
Request parameters
Header parameters
Header parameters
| Header | Description | Example |
|---|---|---|
Authorizationmandatory | string — Bearer token from Step 00 (GetToken) | Bearer {{access_token}} |
Content-Typemandatory | string — Must be application/x-www-form-urlencoded | application/x-www-form-urlencoded |
Path parameters
Path parameters
| Parameter | Description | Example |
|---|---|---|
uuidmandatory | string — Merchant UUID from Step 01 (CreateMerchant) | 11ef-d968-6b042d6c-9b94-02975f21d323 |
Body parameters
Body parameters
| Parameter | Description | Example |
|---|---|---|
merchant[signatory_contact_details_attributes[0][authorised_signatory]]mandatory | string — true for the authorised signatory | true |
merchant[signatory_contact_details_attributes[0][name]]mandatory | string — Signatory full name | Signatory 1 Name |
merchant[signatory_contact_details_attributes[0][pancard_number]]mandatory | string — Signatory PAN | ABCDE1234F |
merchant[signatory_contact_details_attributes[0][email]]mandatory | string — Signatory email | [email protected] |
merchant[signatory_contact_details_attributes[0][contact_detail_type]]mandatory | string — e.g. Signing Authority | Signing Authority |
merchant[signatory_contact_details_attributes[0][cin_number]]conditional | string — CIN only for Pvt Ltd / Public Ltd / OPC | (empty for others) |
Bad Request
Unauthorized - Invalid or expired token
Forbidden - No access to this resource
Not Found
Validation Failed
Internal Server Error