get
https://test-accounts.payu.in/api/v1/merchants/11f0-8ee3-5847ce32-bf72-02975f21d323/list_business_members
List Business Members API
Returns all currently persisted business members for a merchant.
Endpoint
GET /api/v1/merchants/{product_account_uuid}/list_business_members
Base URL
- Test:
https://test-partner.payu.in - Production:
https://partner.payu.in
Auth
- Header:
Authorization: Bearer {access_token} - Required scope:
refer_merchant
Path Parameter
product_account_uuid(string, required): Merchant UUID.
Success Response
200 OK
{
"data": [
{
"id": 3471,
"uuid": "11f1-28f2-7068d69c-879e-02f4a48620c1",
"name": "Test CEO Flow",
"designation": "CEO",
"date_of_birth": "1990-08-15",
"pan_number": "AVGPL0693P",
"date_of_joining": "03/2026",
"active": true
}
]
}Empty State
200 OKwithdata: []when no members exist.
Common Errors
404when UUID is invalid or reseller is not allowed to access that merchant.401/403auth or permission issues.
Recommended Usage
Use this API as the source of truth after every submit/delete member action.
The List Business Members API retrieves business members already submitted for the merchant (Step 13 utility).
Use this after Submit Business Members to confirm what PayU has stored.
HTTP Method: GET
Environment
| URL | |
|---|---|
| Test Environment | https://test-partner.payu.in/api/v1/merchants/{uuid}/list_business_members |
| Production Environment | https://partner.payu.in/api/v1/merchants/{uuid}/list_business_members |
Sample Request
Sample request
curl --location 'https://test-partner.payu.in/api/v1/merchants/{{uuid}}/list_business_members' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Accept: application/json'Sample Response
Success scenario
Success scenario
{
"business_members": [
{
"name": "Director Name",
"pancard_number": "ABCDE1234F",
"designation": "Director"
}
]
}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 |
|---|---|---|
| business_members | array — Submitted business members | [{ name, pancard_number, designation }] |
Request parameters
Header parameters
Header parameters
| Header | Description | Example |
|---|---|---|
Authorizationmandatory | string — Bearer token from Step 00 (GetToken) | Bearer {{access_token}} |
Acceptoptional | string — Preferred response media type | application/json |
Path parameters
Path parameters
| Parameter | Description | Example |
|---|---|---|
uuidmandatory | string — Merchant UUID from Step 01 (CreateMerchant) | 11ef-d968-6b042d6c-9b94-02975f21d323 |
Bad Request
Unauthorized - Invalid or expired token
Forbidden - No access to this resource
Not Found
Validation Failed
Internal Server Error