post https://uat-partner.payu.in/api/v3/merchants//kyc_document
The Create KYC Document API is used to create an instance to upload the KYC document (PAN Card). The access token is required on the header. For more information on getting the access token, refer to Get Token API.
Note:
The access token with the scope as refer_merchant is required on the header. For more information on getting the access token, refer to Get Token API.
Environment
| Test Environment | https://uat-partner.payu.in/ |
| Production Environment | https://partner.payu.in/ |
List of acceptable documents
| Individuals | For individuals, merchant KYC can be done through Aadhaar or CKYC. In case validation fails through the above two mechanisms, the merchant will have to submit document proofs ( POI, POA). |
|---|---|
| Sole Proprietors | For sole proprietors, merchant KYC can be done through Aadhaar or CKYC. If validation fails through the above two mechanisms, the merchant will have to submit document proofs ( POI, POA & government certificate). |
The list of acceptable documents for each category:
POI/ POA:
- Passport
- Aadhar
- Voter’s ID
- Driving Licence
- Utilities Bill (electricity, water, landline, gas connection)”(recent only)
- Address Verification Letter from Bank
Government proof
- GST Registration Certificate
- Udyog Aadhar Card Certificate
- NOC by Gram Panchayat
- TIN Certificate
- Service Tax Registration Certificate
- Shop & Establishment registration
List of Acceptable Bank Proofs
The following are acceptable bank proofs ( with validations):
Passbook
- Must have your name printed
- Must have your account number & IFSC printed
- Must have your photograph & bank stamp
Bank statement
- Must have your name printed
- Must have your account number & IFSC printed
- Mobile banking screenshots & SMS will not be considered valid
Bank verification letter
- Must be on a bank/ your letterhead
- Must have the sign & stamp of a bank manager
- Must have your name, account number & IFSC
Cancelled cheque
- Must have your name printed
- Must have your account number & IFSC printed
The merchant ID in the request header must be included as a query parameter in the mid field.
Sample request
curl --location -g --request POST '{{partner_base_url}}/api/v3/merchants/7210405/kyc_document' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--form 'merchant[document_category]="PAN Card of Signing Authority"' \
--form 'merchant[document_type]="PAN Card"' \
--form 'merchant[processed_document]=@"fVVJ4Dn25/logo_1.jpeg"'
Sample response
{
"merchant": {
"mid": 7210405,
"kyc_document_name": "PAN Card of Signing Authority",
"kyc_document_uuid": "11eb-95ea-acebe9f6-b75f-acbc3279eaa7",
"kyc_document_status": "DOCUMENT_SUBMITTED",
"error_message": "null",
"created_at": "2021-04-05T08:41:13.000Z"
}
}