Indian Documents

The FrankieOne KYC v2 API supports Indian documents for identity verification. This guide outlines the requirements and best practices for handling these documents.

Supported Indian Documents

The FrankieOne KYC v2 API currently supports the following Indian document for identity verification:

DocumentCode
PassportPASSPORT

Passports

Indian passports are official travel documents issued by the Indian government that confirm an individual’s identity and citizenship. They include personal details such as the individual’s name, date of birth, passport number, and file number.

Field NameFieldNotes
Document TypetypeMust be PASSPORT for Indian passports.
CountrycountryMust be IND (India).
Date of BirthdateOfBirthFormat: YYYY-MM-DD. Must match the date of birth as shown on the passport.
NamenameEnter the full name exactly as shown on the passport, including capitalization, special characters, and spaces.

Example Document Structure

1{
2 "document": {
3 "class": "IDENTITY", // Document class must be 'IDENTITY' for KYC verification
4 "primaryIdentifier": "J1234567", // Passport Number: One uppercase letter followed by 7 digits (e.g., 'J1234567')
5 "secondaryIdentifier": "DL1234567890123", // File Number: Two uppercase letters followed by 13 digits (e.g., 'DL1234567890123')
6 "type": "PASSPORT", // Document type must be 'PASSPORT' for Indian passports
7 "country": "IND" // Country code must be 'IND' for India
8 }
9}

Field Requirements

Format Requirements
  • Must consist of one uppercase letter followed by 7 digits
  • Example: J1234567
  • Case sensitive: only uppercase letters are accepted
  • Enter exactly as shown on the passport
Format Requirements
  • Must consist of two uppercase letters (typically the state code) followed by 13 digits
  • Example: DL1234567890123
  • Should be provided in the secondaryIdentifier field
  • Enter exactly as it appears on the passport
Name Requirements
  • Given name and family name are required; middle name is optional
  • Names must match the passport exactly, including capitalization, special characters, and spaces
  • Include the display name exactly as shown on the passport
Key Guidelines for Indian Passport Verification

Name Matching

  • Ensure the name matches the passport exactly, including capitalization, special characters, spaces, and diacritical marks.
  • Enter the full name as displayed on the passport.

Country Code

  • For Indian passports, set the country code to IND.

Passport and File Numbers

  • Enter the passport number in the correct format: one uppercase letter followed by 7 digits (e.g., J1234567).
  • Enter the file number exactly as shown on the passport: two uppercase letters followed by 13 digits (e.g., DL1234567890123).
  • Incorrect or expired document numbers will result in verification failure.

Date of Birth

  • Use the ISO date format (YYYY-MM-DD) for the date of birth.

Best Practices

  • Provide all available optional fields to improve verification accuracy.