Chinese ID Documents

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

1{
2  "familyName": "ZHANG",     // Family name in CAPS
3  "givenName": "WEIMING"     // Given and middle name can be combined
4}
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
Document Number Verification

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.

Was this page helpful?
Built with