Skip to main content
{
  "identityDocs": [
    {
      "idType": "NATIONAL_ID",
      "country": "CHN",
      "idNumber": "123456789012345678",
      "name": {
        "familyName": "ZHANG",
        "givenName": "WEIMING",
        "displayName": "张伟明"
      },
      "extraData": [
        {
          "kvpKey": "home_country_fullname",
          "kvpValue": "张伟明"
        }
      ]
    }
  ]
}

​
Chinese National ID Card (身份证)

The Chinese National ID Card (身份证) is the primary identification document for Chinese citizens. This guide explains how to properly verify these documents in your application.

​
Required Fields

Two name formats are required:
  • Pinyin Name: Romanized version using English alphabet
    • Family name
    • Given name (can include middle name)
  • Chinese Name: Full name in Chinese characters
    The Chinese name supports UTF-8 characters and can be provided in either extraData or name.DisplayName
  • Date of Birth: Must be in YYYY-MM-DD format
  • ID Type: Must be NATIONAL_ID
  • Country: Must be CHN
  • Document Number: The full ID number in idNumber field
Common validation issues to avoid: - Incorrect name format in either Pinyin or Chinese characters - Missing or improperly formatted date of birth - Invalid ID number format

​
Name Handling Guidelines

{
  "familyName": "ZHANG",     // Family name in CAPS
  "givenName": "WEIMING"     // Given and middle name can be combined
}
Name Best Practices
When handling Chinese names:
  1. Always provide both Pinyin and Chinese character versions
  2. Maintain correct character order in both formats
  3. Use uppercase for Pinyin names
  4. Ensure UTF-8 encoding for Chinese characters
The Chinese National ID number contains encoded information including:
  • Region code
  • Birth date
  • Sequence number
  • Checksum digit
Ensure the full number is provided without spaces or special characters.