get
https://test-accounts.payu.in/api/v3/merchants//kyc_document/required_docs
The Fetch Required KYC Documents API returns document categories and accepted types for the merchant (Step 14 of 16).
Notes:
- Entity applicability: All entities — the required list differs by entity type.
- Use each category
nameasmerchant[document_category]and each typenameasmerchant[document_type]in Step 15.
HTTP Method: GET
Environment
| URL | |
|---|---|
| Test Environment | https://test-partner.payu.in/api/v3/merchants/{mid}/kyc_document/required_docs |
| Production Environment | https://partner.payu.in/api/v3/merchants/{mid}/kyc_document/required_docs |
Mapping to Step 15 - Upload KYC Documents:
document_categories[i].name→merchant[document_category];document_categories[i].document_types[j].name→merchant[document_type].
Sample request
Sample request
curl --location 'https://test-partner.payu.in/api/v3/merchants/{{mid}}/kyc_document/required_docs' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Accept: application/json'Sample response
Success scenario
Success scenario
{
"document_categories": [
{
"uuid": "11e8-748f-297824ce-9081-020aca9875be",
"name": "PAN Card of Signing Authority",
"document_types": [
{
"uuid": "11e8-748f-2946799c-9081-020aca9875be",
"name": "PAN Card"
}
],
"kyc_document": null
}
]
}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 |
|---|---|---|
| document_categories | array — Required document categories for this merchant | [{ uuid, name, document_types, kyc_document }] |
| document_categories[].name | string — Category name → merchant[document_category] in Step 15 | PAN Card of Signing Authority |
| document_categories[].document_types[].name | string — Type name → merchant[document_type] in Step 15 | PAN Card |
| document_categories[].kyc_document | object/null — Existing upload status when already submitted | null or { "status": "Approved" } |
Additional request parameters info
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 |
|---|---|---|
midmandatory | string — Numeric merchant ID (mid) from Step 01 | 8390925 |
Bad Request
Unauthorized - Invalid or expired token
Forbidden - No access to this resource
Not Found
Validation Failed
Internal Server Error