post
https://test-accounts.payu.in/api/v3/merchants/kyc_document/ckyc_data
The Fetch CKYC Data API fetches CKYC identity data using PAN without OTP (Step 03-C of 16).
Notes:
- Prerequisites: Step 01 (
mid); Step 02 with a non-Individual / non-Sole Prop entity type.- Entity applicability: Partnership, Pvt Ltd, Public Limited, LLP, Trust, Society, One Person Company, Government, NGO, HUF, and similar.
HTTP Method: POST
Environment
| URL | |
|---|---|
| Test Environment | https://test-partner.payu.in/api/v3/merchants/kyc_document/ckyc_data |
| Production Environment | https://partner.payu.in/api/v3/merchants/kyc_document/ckyc_data |
Sample Request
Sample request
curl --location 'https://test-partner.payu.in/api/v3/merchants/kyc_document/ckyc_data' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Content-Type: application/json' \
--data '{
"merchant_id": "{{mid}}",
"consent": true
}'Sample Response
Success scenario
Success scenario
{
"ckyc_number": "XXXXXXXXXXXX",
"name": "ACME PRIVATE LIMITED",
"father_name": "",
"dob": "15-03-2020",
"address": "123 MG Road",
"pincode": "560001",
"state": "Karnataka",
"city": "Bangalore",
"related_persons_data": []
}Failure scenario
Failure scenario
- 422 — Consent missing or CKYC record not found
{
"error": "CKYC record not found"
}Response parameters
Response parameters
| Parameter | Description | Example |
|---|---|---|
| ckyc_number | string — CKYC identification number from CERSAI | XXXXXXXXXXXX |
| name | string — Entity name in CKYC | ACME PRIVATE LIMITED |
| dob | string — Date of incorporation (DD-MM-YYYY) | 15-03-2020 |
| address | string — Registered address from CKYC | 123 MG Road |
| pincode | string — Pincode from CKYC | 560001 |
| state | string — State from CKYC | Karnataka |
| city | string — City from CKYC | Bangalore |
| related_persons_data | array — Related persons (directors/partners); may be empty | [] |
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/json | application/json |
Body parameters
Body parameters
| Parameter | Description | Example |
|---|---|---|
merchant_idmandatory | string — Numeric mid from Step 01 | 12345678 |
consentmandatory | boolean — Must be true | true |
Bad Request
Unauthorized - Invalid or expired token
Forbidden - No access to this resource
Not Found
Validation Failed
Internal Server Error