Skip to main content

CustomerDataNgIdCard

Extends CustomerDataDto: the object also contains its base fields (country, documentType, firstName, lastName and the optional customerId), which are not repeated below. The fields listed here are specific to this country and document type.

middleNamestring

The MIDDLE NAME printed in its own labelled field on the card (e.g. "CHIAMAKA"). Absent on some documents, leave it out then. Optional: sending it together with the first name in firstName is also accepted. Every word is fuzzy-matched individually against the OCR. Never fails the match: a middle name the document does not show is reported as not matching in the breakdown, without rejecting the document. Not verified against the MRZ, which writes spaces and hyphens alike and cannot separate the middle name.

documentNumberstring

The 10-digit DOCUMENT No printed on the front (e.g. "5394260618"). Not the large 16-digit payment number. Spaces are stripped.

sexstring

The sex of the document holder — printed short; the label varies between SEX and GENDER

Possible values: [F, M]

nationalitystring

Nationality of the document holder (ISO-3 "NGA" as printed).

birthDate object

Verified against the MRZ (YYMMDD); the printed month abbreviation length varies across card prints.

oneOf
number

Unix timestamp in milliseconds

expirationDate object

Verified against the MRZ; the card face prints only MM/YY.

oneOf
number

Unix timestamp in milliseconds

issueDate object

Printed DD MMM YY (e.g. "21 MAY 13"); not present in the MRZ, so it is verified against the OCR.

oneOf
number

Unix timestamp in milliseconds

heightstring

The height, canonically as printed (e.g. "180cm"); "180 CM", "180", "1.80" and "1.80m" are normalized to it. Matched exactly (a split "180 cm" print is glued before matching): on the 5-char token a one-digit difference sits exactly at the 0.8 fuzzy threshold, so fuzzy matching could not reject a wrong height.

CustomerDataNgIdCard
{
  "middleName": "string",
  "documentNumber": "string",
  "sex": "F",
  "nationality": "string",
  "birthDate": 0,
  "expirationDate": 0,
  "issueDate": 0,
  "height": "string"
}