...
- Some drivers licence checks (not all states).
- Most DVS checks - driver's licences, passport, visa and Medicare.
- Dun and Bradstreet illion Credit Header.
The rest of this page discusses these types of checks, and what is required to cause them to be run upon registration.
Common to all the checks is the requirement to pass additional data fields in the "extraData" or "optionalData" element of the web service method. The extraData or optionalData element contains a list of name-value pairs, and if the correct entries are present, then additional background checks will be performed.
| Table of Contents |
|---|
Background
...
DVS
...
To perform background driver's license checks, greenID needs to know the driver's license information, which can be passed along with the rest of the information sent in registration web service call. The extra driver's licence information is passed in the list of name-value pairs in the "extraData" or "optionalData" field. The extra fields that can be passed are:
- driversLicenceNumber
- driversLicenceState
- driversLicenceExpiryDate
- driversLicenceRTANumber
The first two fields, namely driversLicenceNumber and driversLicenceState are mandatory; if either or both are missing, then the check will not be performed. The driversLicenceExpiryDate field is optional for all states except Western Australian driver's licenses. The driversLicenceRTANumber field is mandatory for NSW drivers licence checks only.
The driversLicenceNumber field is used directly for the check, it is not modified in any way, so it must be provided exactly as it appears on the licence.
The driversLicenceState fields must be one of:
- NSW
- VIC
- ACT
- QLD
- SA
- WA
Any other values are ignored; if a valid state is not present, then a driver's licence check will not be performed.
The driversLicenceExpiryDate field is also used directly for the check, and is not modified in any way. It is expected that it will be a string of the form DD/MM/YYYY. If a valid date is not found, then none will be used, which may cause the check to fail.
The result of the background driver's licence check will be returned in the standard RichVerificationResult element returned by the web service call (either the regular greenID web services, or the greenID API).
Background DVS Checks
There are four different kinds of DVS checks that can be performed in background mode:
...
- driversLicenceState - the driver's licence state; must be one of: ACT, NSW, NT, QLD, SA, TAS, VIC or WA. This field is required.
- driversLicenceNumber - the driver's licence number, exactly as it appears on the licence. This field is required. This field must have the value as shown on the drivers licence.
- driversCardNumber - the driver's licence card number, exactly as it appears on the licence. This field should only be passed if you have driver's licence card number enabled for your account. Please note that checking the drivers's licence card number is not supported by the DVS for all states at the moment, please contact your integration consultant for more information.
The person's name details, as provided in the other parameters to the registration web service method, are used, so passing an additional name is not required.
...
...
illion Credit Header
If the Dun and Bradstreet illion Credit Header is configured for an account there are two ways it can be run in the background:
- The default setting is to run the Credit Header for all registrations. This can only be done when all people registered with greenID have given explicit approval for their details to be tested against the Credit header. This consent must be obtained by the customer.
- We can receive a flag via the extraData or optionalData element to indicate that the person has given explicit approval to be run against the Credit Header. Add an extraData or optionalData element with the name "dnb-credit-header-consent-given" with the value "true" to indicate that consent has been given. If you require this option, please contact us.
Background NZ Driver's Licence Checks
To initiate a background NZ driver's licence check, the following fields must be passed in the extraData or optionalData element:
- driversLicenceNumber - the driver's licence number, exactly as it appears on the licence. This field is required. This field must have the value as shown on the drivers licence.
- driversLicenceVersion - the driver's licence version number, exactly as it appears on the licence. This field is required. This field must have the value as shown on the drivers licence.
The person's name details, as provided in the other parameters to the registration web service method, are used, so passing an additional name is not required.
Background NZ Passport Checks
To initiate a background NZ Passport check, the following fields must be passed in the extraData or optionalData element:
- passportNumber - the passport number, exactly as it appears on the document. This field is required. This field must have the value as shown on the NZ issued passport.
- passportExpiryDate - the expiry date, exactly as it appears on the document. This field is required. This field must have the value as shown on the NZ issued passport.
The person's name details, as provided in the other parameters to the registration web service method, are used, so passing an additional name is not required.
Legacy Background Driver's Licence Checks (non-DVS)
To perform background driver's license checks, greenID needs to know the driver's license information, which can be passed along with the rest of the information sent in registration web service call. The extra driver's licence information is passed in the list of name-value pairs in the "extraData" or "optionalData" field. The extra fields that can be passed are:
- driversLicenceNumber
- driversLicenceState
- driversLicenceExpiryDate
- driversLicenceRTANumber
The first two fields, namely driversLicenceNumber and driversLicenceState are mandatory; if either or both are missing, then the check will not be performed. The driversLicenceExpiryDate field is optional for all states except Western Australian driver's licenses. The driversLicenceRTANumber field is mandatory for NSW drivers licence checks only.
The driversLicenceNumber field is used directly for the check, it is not modified in any way, so it must be provided exactly as it appears on the licence.
The driversLicenceState fields must be one of:
- NSW
- VIC
- ACT
- QLD
- SA
- WA
Any other values are ignored; if a valid state is not present, then a driver's licence check will not be performed.
The driversLicenceExpiryDate field is also used directly for the check, and is not modified in any way. It is expected that it will be a string of the form DD/MM/YYYY. If a valid date is not found, then none will be used, which may cause the check to fail.
The result of the background driver's licence check will be returned in the standard RichVerificationResult element returned by the web service call (either the regular greenID web services, or the greenID API).