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
API Result
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
- 1 NZ DL - Failure Reason
- 1.1 Result Example
- 1.1.1 Audit Logs
- 1.1.2 API Result
- 1.1 Result Example
- 2 NZ Passport - Failure Reason
- 2.1 Result Example
- 2.1.1 Audit Logs
- 2.1.2 API Result
- 2.1 Result Example