Open API >Information Service >ID Card Number Verification
ID Card Number Verification
Information Service Merchant Acquirer Issuer Non-financial Institutions
Verify the consistency of real name information of China resident identity card.
API Introduction
API Introduction
What is it?

Based on real name information from authoritative data sources, ID card verification service can verify the consistency of name and ID number under the premise of obtaining the authorization of the subject.

Key Features

Real name Verification

When to Use it?

Bank: Account Opening

Insurance company: Insurance Claims

Securities company:  Account Opening & Bind card to pay


Who Use it?
Financial & non-financial institutions that demands to verify identity information of China residents.
Where to Use it?
This API is available globally.
Flow Chart
Flow Chart

身份证信息验证,人像比对-流程图.png

1. Merchant / Institution provides ID card information and photo to be verified.

2. UPI System transmits the ID card information and photo to The Ministry of Public Security

3. The Ministry of Public Security returns verification result to UPI

4. UPI returns verification result to Merchant / Institution


API Reference
API Reference
  • ID_CARD_NUMBER_VERIFICATION
Interface description
ID_CARD_NUMBER_VERIFICATION API is used to verify whether the customer’s name is consistent with the customer’s ID Number.
Request Method
HTTP POST
Request Parameter
Field name Identifier Type Length Request Default value Note
Member IIN memberIIN AN 8 None The distinctive value associated to the Member by UPI. If you are already a member, please fill your IIN here.If you are a merchant, please fill your acquirer’s IIN here.
Member Name memberName ANS 1-40 None The UPI member’s name. If you are already a member, please fill your name here.If you are a merchant, please fill your acquirer’s name here.
Merchant ID merchantID ANS 1-15 None The distinctive value associated to the Merchant. The value must uniquely identify any Merchant of the Acquirer.If you are already a member, the field will not be presented.If you are a merchant, please fill your MID here.
Merchant Name merchantName ANS 1-25 None The Merchant that uses the API interface.If you are already a member, the field will not be presented.If you are a merchant, please fill your name here.
Merchant Category Code mcc N 4 None If you are already a member, the field will not be presented.If you are a merchant, please fill your MCC here.
Trade Type tradeType N 6 None The value of trade type is as follows:ID0201
Encrypted Data encData Object None JWE
Customer Name customerNm S 1-66 None Encrypted with the public key of the Encryption Certificate. The name shall be in accordance with the simplified Chinese
ID Number certifID ANS 1-20 None Encrypted with the public key of the Encryption Certificate.
Transaction Order ID orderID ANS 35 None Generated by Merchant side, and it should be unique.
Usage Scenarios scUsageScenarios ANS 2-40 None The scenario that the Participants uses the API interface.
Use Purpose scUsePurpose ANS 2-128 None The purpose that the Participants uses the API interface.
Protocol Version Number protocolVerNm ANS 2-128 None The protocol version number of the electronic agreement that the customer signed with the Participants.
Serial Number serialNm ANS 14-64 None The serial number of the electronic agreement that the customer signed with the Participants. The serial number should be able to locate the date of signing the agreement. Pad “0” ahead if digits are insufficient.
Synchronous Response parameters
Filed name Identifier Type Length Request Default value Note
Message Response msgResponse Object None
Response Code responseCode AN 2 None It contains a code that defines the response to a request.
Response Message responseMsg S 1-100 None It contains the request result and the rejection reason if the request fails. The value of this field can be displayed by the Gateway to notify the user of the request outcome.
Error Details errorDetail S 1-255 None It contains additional detail regarding the problem identified in the message.
Security Requirement
Security Requirement


UnionPay International has adopted unified security requirement, please refer to UPI Server-based API General Requirements  for signature and encryption guide.


Steps to Launch
Steps to Launch

Please submit order to contact Developer Team

  • Contact Us
  • If you have any further questions, please register and submit order in your user center.