KYCImplementation GuideCountry-Specific Documents

Thai Documents

The FrankieOne KYC v2 API supports some Thai documents for identity verification. This guide provides details on how to handle these documents effectively.

Supported Thai Documents

The FrankieOne KYC v2 API supports the following Thai documents:

DocumentCode
National IDNATIONAL_ID

National ID (บัตรประจำตัวประชาชน)

National ID Cards (บัตรประจำตัวประชาชน) are official identification documents issued by the Thai government that confirm an individual’s identity and citizenship. They include personal details such as the individual’s name, date of birth, ID card number, and expiration date.

Required Fields

Field NameFieldNotes
CountrycountryMust be set to THA
Date of BirthdateOfBirthMust be in YYYY-MM-DD format
Document TypetypeMust be NATIONAL_ID
NamenameEnter the full name exactly as it appears on the National ID card, including all given, middle, and family names.

Thai National ID numbers are 13 digits long and follow a specific structure:

  • 1st digit: Registration category
  • 2nd–5th digits: Province or office code
  • 6th–12th digits: Personal unique number
  • 13th digit: Check digit (used for validation)

Example: 1-2345-67890-12-3

The laser code is an alphanumeric identifier printed on the back of the Thai National ID card. It is used as an additional security feature and must be entered exactly as shown, including case sensitivity.

Example: JT0-1234567-89

Example Document Structure

1{
2  "document": {
3    "class": "IDENTITY", // Document class must be 'IDENTITY' for KYC checks
4    "documentId": "92de15f64-5717-4562-b3fc-2c963f6665a7", // Unique identifier for this document instance (UUID format)
5    "primaryIdentifier": "000734130", // 13-digit Thai National ID number (must match the card exactly)
6    "secondaryIdentifier": "q12313124", // Laser code from the back of the card (case-sensitive, must match exactly)
7    "type": "NATIONAL_ID", // Document type code for Thai National ID
8    "country": "THA" // Country code for Thailand (ISO 3166-1 alpha-3)
9  }
10}
Important Considerations for Thai National ID

To ensure successful verification, pay attention to these common issues:

  • The ID number must be exactly 13 digits and pass the official checksum validation.
  • Names must match the ID card exactly, including spelling, order, and spacing. Support Thai characters to prevent transcription errors.
  • The date of birth must be in YYYY-MM-DD format.
  • The laser code must be entered exactly as shown on the back of the card, including case sensitivity.