Create 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 Environmenthttps://uat-partner.payu.in/
Production Environmenthttps://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 ProprietorsFor 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"
  }
}

Request parameters

Language
Authorization
Bearer
URL
Click Try It! to start a request and see the response here!