Philippines Documents

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

Supported Philippines Documents

The FrankieOne KYC v2 API supports the following Philippines documents:

DocumentCode
PassportPASSPORT

Passports

Philippine passports are official travel documents issued by the Department of Foreign Affairs (DFA) of the Philippines. They include personal details such as the individual’s name, date of birth, passport number, and other identifying information.

Required Fields

Field NameFieldNotes
CountrycountryMust be set to PHL
Date of BirthdateOfBirthMust be in YYYY-MM-DD format
Document TypetypeMust be PASSPORT
NamenameEnter the full name exactly as it appears on the passport, including all given, middle, and family names

Example Document Structure

1{
2 "document": {
3 "class": "IDENTITY", // Document class must be "IDENTITY" for passports
4 "primaryIdentifier": "P1234567", // Passport number: 1 letter + 7 digits (e.g., "P1234567")
5 "type": "PASSPORT", // Document type must be "PASSPORT"
6 "country": "PHL" // Country code must be "PHL" for the Philippines
7 }
8}
Common Validation Issues

Ensure the following to avoid validation failures:

  • Passport number must be exactly 8 characters: 1 letter (usually P) followed by 7 digits (e.g., P1234567)
  • Full name (given, middle, and family names) must match the passport exactly, including capitalization, spaces, special characters, and diacritical marks
  • All middle names and compound surnames must be included as shown on the passport
  • Date of birth must be in YYYY-MM-DD (ISO) format
  • Country code must be set to PHL
  • Document type must be PASSPORT
Verification Checklist
  • Passport number format: 1 letter + 7 digits (e.g., P1234567)
  • Name fields match passport exactly (spelling, order, spaces, capitalization)
  • All required fields are present: country, dateOfBirth, type, name, primaryIdentifier