put
https://test-accounts.payu.in/api/v1/merchants//submit_business_members
The Submit Business Members API submits directors, partners, or designated partners (Step 13 of 16).
Entity applicability: Required for Private Limited, Public Limited, Partnership, and LLP. Not required for Individual, Sole Prop, Trust, Society, or OPC.
HTTP Method: PUT
Environment
| URL | |
|---|---|
| Test Environment | https://test-partner.payu.in/api/v1/merchants/{uuid}/submit_business_members |
| Production Environment | https://partner.payu.in/api/v1/merchants/{uuid}/submit_business_members |
Sample request
Sample request
curl --location --request PUT 'https://test-partner.payu.in/api/v1/merchants/{{uuid}}/submit_business_members' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Content-Type: application/json' \
--data '{
"business_members": [
{
"name": "Director Name",
"pancard_number": "ABCDE1234F",
"designation": "Director"
}
]
}'Sample response
Success scenario
Success scenario
{
"message": "Business members submitted successfully"
}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 |
|---|---|---|
| message | string — Submission confirmation | Business members submitted successfully |
Additional request parameters info
Header parameters
Header parameters
| Header | Description | Example |
|---|---|---|
Authorizationmandatory | string — Bearer token from Step 00 (GetToken) | Bearer {{access_token}} |
Content-Typemandatory | string — Must be application/json | application/json |
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 |
|---|---|---|
business_membersmandatory | array — List of business member objects | [{ name, pancard_number, designation }] |
business_members[].namemandatory | string — Member name | Director Name |
business_members[].pancard_numbermandatory | string — Member PAN | ABCDE1234F |
business_members[].designationmandatory | string — Role (e.g. Director, Partner) | Director |
Bad Request
Unauthorized - Invalid or expired token
Forbidden - No access to this resource
Not Found
Validation Failed
Internal Server Error