/
NZ Passport and NZ Driver's Licence - Failure Reason

NZ Passport and NZ Driver's Licence - Failure Reason

greenID has made some changes to return ‘no match’ or ‘failure reasons' for NZ DL and Passports. Below is an overview of how these results will be returned.

NZ DL - Failure Reason

This feature is available in Test and Production now.

The NZ Driver’s Licence source will return a ‘failure’ reason which when the NZ DL has a no matched result. The reason will be returned in the ‘extra data’ section of the API (v3-5) and in the admin panel audit logs.

  • The source first checks if the DL numbers and version number have been matched. If not, the reason returned will be: Licence not found

  • When the document number and version number match but other elements don’t match, the source will return one of the following in reasons (in this order):

    • Date of Birth not matched

    • Family Name not matched

    • First Name not matched

    • Other Name not matched

Result Example

Audit Logs

image-20241202-113322.png

API Result

image-20241202-113304.png

NZ Passport - Failure Reason

This feature is available in Test now and will be in Production on 16th Dec 2024.

The NZ Passport source will return a ‘failure’ reason which when the NZ Passport has a no matched result. The reason will be returned in the ‘extra data’ section of the API (v3-5) and in the admin panel audit logs.

  • The source first checks if the Passport number has been matched. If not, the reason multiple failure reasons are returned:

    • First Name not matched

    • Official surname not matched

    • Date of birth not matched

    • Date valid to not matched

  • When the document number match but other elements don’t match, the source will return one of the following in reasons:

    • First Name not matched

    • Official surname not matched

    • Date of birth not matched

    • Date valid to not matched

Result Example

Audit Logs

API Result

 

Related content