...
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 Checks
There are four different kinds of DVS checks that can be performed in background mode:
- driver's licence checks (all states);
- Medicare card checks;
- Australian Passport checks; and
- Visa checks.
The sections below provide details on how to initiate each of these checks in background mode.
Background DVS Driver's Licence Checks
To initiate a background DVS driver's licence check, the following fields must be passed in the extraData element:
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. Card number is a mandatory field for some states, please refer to our FAQ: DVS Driver Licence Card Number Change - FAQ Sheet.
Background DVS Medicare Card Checks
To initiate a background DVS Medicare card check, the following fields must be passed in the extraData element:
medicareCardNumber- the Medicare card number. This field is required. This field must have the value as shown on the Medicare card.medicareIndividualReferenceNumber- the person's individual reference number on their Medicare card. This field is required. This field must have the value as shown on the Medicare card.medicareCardExpiryDate- the Medicare card expiry date. The expected format for regular green Medicare cards is MM/YYYY, and for blue and yellow Medicare cards, the expected format is DD/MM/YY. This field is required. This field must have the value as shown on the Medicare card.medicareCardColour- the colour of the Medicare card. For regular green Medicare cards, the expected value is "G". For blue Medicare cards, the expected value is "B", and for yellow Medicare cards, the expected value is "Y". This field is required.medicareNameOnCard- the person's name as it appears on the Medicare card. This field is optional; if it is not provided, then the person's name details from the other parameters are used, and will be converted the usual Medicare format of given name followed by the first letter of the middle name(s) followed by the surname. This field must have the value as shown on the Medicare card.
Medicare card can only be used as a background source if the name is on one line. Names that wrap across more than one line will not pass as a background check.
Background DVS Australian Passport Checks
To initiate a background DVS Australian Passport check, the following fields must be passed in the {{extraData} element:
...
The person's name details from the other parameters are used.
Background DVS Visa Checks
To initiate a background DVS Visa check, the following fields must be passed in the extraData element:
...
Background DVS Australian Electoral Roll Checks (AEC)
If the Australian Electoral Roll is configured for an account there are two ways it can be configured to run in background mode:
- Always run at registration.
- Only run when it can verify the individual (this may happen after interactive source checks too).
For more information about these options, please talk to your GBG representative.
For both cases, explicit consent is required for the source and must be collected by the customer.
illion Credit Header
If the 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-givenwith the valuetrueto 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 element. The extra fields that can be passed are:
...