Configuring GBG ID3global

GBG ID3global is a data provider you can use to run these checks:

  • Bank account verification using a CRA
  • Electronic identity check
  • ID verification (PassFort collects documents)

Bank account verification using a CRA

How it works

This is the default behaviour for a variant of the Bank account verification using a CRA check with GBG ID3global as the data provider.

The check is performed by searching the individual’s bank account details (sort code and account number) and personal details (name, address, and date of birth) in the credit rating agency’s (CRA’s) database.

The check passes when the CRA verifies the bank account belongs to the individual.

If one or more of the individual’s details do not match the details in the CRA’s database, the check fails.

If the individual’s profile doesn’t have data for the required fields, an error is displayed.

If the country of address in the individual’s profile isn’t covered by GBG ID3global, an error is displayed.

You can also configure this check to see if the bank account number is valid for any individual. See Configuration options for more details.
To improve the accuracy of the results, provide the customer's middle name.

Configuration options

You have the following configuration option:

  • Use the most recent previous address if the check fails (optional): When this option is selected, if the check fails the first time it's run and there's more than one address in the address history, the check is run a second time automatically using the most recent address that isn't the current address. The check is only run again automatically once. Any time the check is run again automatically, you are charged for a second check. If the addresses provided on the individual's profile do not include dates, the addresses used for this check are selected at random.
  • Attempt bank account validation if the check fails (Resold checks only) (optional): When this option is selected, if the initial check shows that the account details do not match the individual in the profile, a second check is run to see if the bank account is valid for any individual. If the bank account is valid, the check result is determined by the configuration option for Result when verification fails but validation passes. Any time the check is run for bank validation, you will be charged again as a separate check. Note that this configuration option is only used when you have selected a PassFort reselling commercial agreement.
  • Result when verification fails but validation passes (optional): Determines which check result is returned when bank validation fails but bank verification passes. The options you can select are Pass, Partial, or Fail. If you've selected PassFort reselling as your commercial agreement, this option is only used if you've also selected Attempt bank account validation if the check fails. If you've selected Direct agreement as your commercial agreement, this option is only used if you're using a GBG profile that has bank verification and bank validation. Note that with the GBG profile, you can have bank validation execute on the condition that bank verification fails, but you must always have bank verification as well.

What we’ll need

Let us know that you’d like to add a variant of the Bank account verification using a CRA check with GBG ID3global and whether you'd like to use the configuration option. We’ll set it up for you.

If you have a direct agreement with GBG ID3global, we’ll also need:

  • The URL for your GBG ID3global API (e.g. https://www.id3global.com/ID3gWS/ID3global.svc?wsdl)
  • A GBG ID3global account set up just for PassFort, and the username of that account
  • The GBG Profile(s) for the jurisdiction(s) for your checks. For each GBG Profile, we need the Country of Applicant (the jurisdiction) and the Profile ID.

Learn how to create a GBG ID3global account and get your username and profile IDs.

If you have a direct agreement with GBG ID3global, an error is displayed if the check is run on a profile with a current country of address that does not match a Country of Applicant for one of the GBG Profiles you’ve provided.

Testing your configuration

Once the check variant is configured, follow these steps in your demo environment to test whether it's working as expected.

If you are not using the bank account validation configuration options:

  1. Does the check pass when GBG ID3global verifies the bank account is valid and belongs to the individual in the profile? To run the test, create any individual profile and run the check variant. If the check passes, it’s working as expected.
  2. Does the check fail when GBG ID3global indicates the bank account does not belong to the individual in the profile? To run the test, create an individual profile with "FAIL" as a given name or surname (e.g. "Alex FAIL Wheeler") and run the check variant. If the check fails, it’s working as expected.

If you are using bank account validation configuration options:

  1. Does the check pass when GBG ID3global can verify and validate the bank account? To run the test, create any individual profile and run the check variant. If the check passes, it’s working as expected.
  2. Does the check pass when GBG ID3global can verify the bank account but does not return any validation result because validation is not run? To run the test, create any individual profile with "VerificationOnly" as a given name or surname (e.g. "Alex VerificationOnly Wheeler) and run the check variant. If the check passes, it's working as expected. Note that in this case, the bank account is assumed to be valid because it was verified as belonging to the individual.
  3. Does the check fail when GBG ID3global cannot verify or validate the bank account? To run the test, create an individual profile with "FAIL" as a given name or surname (e.g. "Alex FAIL Wheeler") and run the check variant. If the check fails, it’s working as expected.
  4. What does the check return when GBG ID3global cannot verify the bank account, but can successfully validate it? To run the test, create an individual profile with "FailVerification" as a given name or surname (e.g. "Alex FailVerification Wheeler") and run the check variant. If the check result matches your selection for the Result when verification fails but validation passes configuration option, it's working as expected.
In the live environment, an error is displayed when the check is run on a profile with a country of address that isn’t covered by GBG ID3global. This error is not displayed in the demo environment.
The test words are not case-sensitive.

Required and optional profile fields

These are the profile details searched in GBG ID3global’s sources:

Name

Description

First name(s) (personal_details.name.given_names)

Required

The individual’s first and, if applicable, middle names.

Surname (personal_details.name.family_name)

Required

The individual’s last name.

Date of birth (personal_details.dob)

Required

The individual’s date of birth.

Addresses (address_history)

Required

The individual’s address history.

Bank account (banking_details.bank_accounts)

Required

The individual’s bank account details, including sort code and account number, country, and type.

Electronic identity check

How it works

This is the default behaviour for a variant of the Electronic identity check with GBG ID3global as the data provider.

This check is performed by searching the individual’s details (name, date of birth, address, and, if available, phone number; in some cases, national identity number, passport number, and driving licence number are also sent) in the sources supplied by GBG ID3global.

The check passes when a 2+2 result is achieved, which happens when either of these conditions are true:

  1. The individual’s full name and address are matched in one source and the individual’s full name and date of birth are matched in a second source.
  2. The individual’s full name and address are matched in two distinct sources.

If a 2+2 result cannot be achieved, the check looks for a 1+1 result.

The check returns a partial match when a 1+1 result is achieved, which happens when either of these conditions are true:

  1. The individual’s full name, date of birth, and address are matched in one source.
  2. The individual’s full name and address are matched in one source.

If the conditions are not met for a 2+2 result or a 1+1 result, the check fails.

If the individual’s profile doesn’t have data for the required fields, an error is displayed.

If the country of address in the individual’s profile isn’t covered by GBG ID3global, an error is displayed.

Although in some cases the individual's national identity number is required to search GBG ID3global's sources, the Electronic identity check does not confirm the validity of the individual’s national identity number by default. If you want to use this check to confirm the validity of the national identity number, use the Identity number is one of the required fields configuration option.

Configuration options

You can use the following configuration options:

  1. Configure custom matching rules: When this option is selected, you can input your own rules.

    To configure a new custom matching rule, use these steps:

    1. Click the Add custom rule button, then click the down arrow to expand your new custom rule fields.
    2. Give your rule a meaningful name.
    3. Click in the Result field and select a result from the menu.
      • Fail: The individual's details were not matched.
      • 1+1: The individual's details were matched in one source.
      • 2+2: The individual's details were matched in at least two sources.
    4. Enter the Database type to search. You can start typing the name of a database type or click into the field and select from the menu that appears. Select the database types that you need.
    5. Click into the Requires field and select the requirements that you need from each database. For example, you can specify that Forename, Surname, and DOB are required from one database and Forename, Surname, and Address are required from another database.
    6. Note that a match in a mortality database will return a fail result. The individual’s full nameaddress, and if provided, date of birth are searched in GBG ID3global's mortality lists. If a match is found for the full name and address or a match is found for the full name and date of birth, the check fails and the mortality confidence level from GBG ID3global is displayed in the result details next to the source name. This configuration option is only used when the check is run in the United States.
    7. If needed, select the Distinct sources checkbox. This checkbox applies when you have two or more lines of requirements. Selecting this checkbox means that each line of requirements must come from a different database.
      If you have multiple lines and Distinct sources is not selected, each line of requirements can be satisfied by matches from the same database.

    You can add more custom rules, the first rule whose requirements are met will become the active rule. Re-order these at any time by clicking on and holding the grab bar, then, drag the rules into the order you want them.

    If you are using mortality checks, PassFort recommends setting up Fail rules first in order of precedence.

  2. Pass check on 1+1 result (optional): When this option is selected, the check passes when a 1+1 result is achieved. When this configuration option is used, a partial match is never returned.
  3. Date of birth must match in one source to achieve a 1+1 or 2+2 result (optional): When this option is selected, it’s only possible to achieve a 2+2 result or a 1+1 result when the individual’s date of birth is matched in GBG ID3global’s sources. In other words, a 2+2 result is only achieved if the individual’s full name and address are matched in one source and the individual’s full name and date of birth are matched in a second source. A 1+1 result is only achieved when the individual’s full name, date of birth, and address are matched in one source.
  4. Fail the check if a mortality result is found (optional): When this option is selected, the individual’s full nameaddress, and if provided date of birth are searched in GBG ID3global's mortality lists. If a match is found for the full name and address or a match is found for the full name and date of birth, the check fails and the mortality confidence level from GBG ID3global is displayed in the result details next to the source name. This configuration option is only used when the check is run in the United States.
  5. Fail the check if a COPPA alert is found (optional): When this option is selected, the check fails if an alert is found for the Children's Online Privacy Protection Rule (COPPA). This configuration option is only used when the check is run in the United States.
  6. Validate the date of birth if the year matches (optional): When this option is selected, the individual's date of birth is considered validated as long as the year of birth matches.
  7. Identity number must match in one source to achieve a 1+1 or 2+2 result (optional): When this option is selected, the individual’s national identity number is required to achieve a 1+1 result, meaning that a 1+1 result is achieved when one of the following conditions is true:
    1. The individual’s full name, date of birth, address, and national identity number are matched in one source.
    2. The individual’s full name, date of birth, address, and the last 4 digits of their national identity number are matched in one source.
    3. The individual’s full name, address, and national identity number are matched in one source.
    4. The individual’s full name, address, and the last 4 digits of their national identity number are matched in one source.
    Additionally, the check only passes when the national identity number is verified in GBG ID3global’s sources. The check displays an error if it’s run on an individual profile that doesn’t have a national identity number.

    When this option is selected, it’s not possible to achieve 2+2 results.
When the DOB is one of the required fields and Identity number is one of the required fields configuration options are both used, a 1+1 result can only be achieved when one of the following conditions is true: 1) The individual’s full name, date of birth, address, and national identity number are matched in one source; 2) The individual’s full name, date of birth, address, and the last 4 digits of their national identity number are matched in one source. It’s not possible to achieve 2+2 results.
  1. Full identity number must match instead of the last 4 digits (optional): When this option is selected, the full national identity number must match instead of the last 4 digits.
  2. Address must match to achieve a 1+1 or 2+2 result (optional; enabled by default): When this option is selected, the check behaves in the way described in How it works. When this option is deselected, it is possible to achieve 1+1 results as long as the check is run in the United States and the Identity number must match in one source to achieve 1+1 or 2+2 results configuration option is in use.

    A 1+1 result can be achieved when any of the following conditions are true:
    1. The individual’s full name, date of birth, address, and national identity number are matched in one source.
    2. The individual’s full name, date of birth, address, and the last 4 digits of their national identity number are matched in one source.
    3. The individual’s full name, address, and national identity number are matched in one source.
    4. The individual’s full name, address, and the last 4 digits of their national identity number are matched in one source.
    5. The individual's full name, date of birth, and national identity number are matched in one source.
    6. The individual's full name, date of birth, and the last 4 digits of their national identity number are matched in one source.
    7. The individual's full name and national identity number are matched in one source.
    8. The individual's full name and the last 4 digits of their national identity number are matched in one source.
    When this option is deselected, it is not possible to achieve 2+2 results.

    Note that Identity number must match in one source to achieve 1+1 or 2+2 results must be enabled. If it is disabled, deselecting Address must match to achieve a 1+1 or 2+2 result will not have any effect and the check behaviour will continue as described in How it works.
  3. Use the most recent previous address if the result isn't 2+2 (optional): When this option is selected, the individual’s most recent address is used to run the check. With this option, if the check fails or a partial match is returned, the check is run again automatically using the next most recent address. The check is only run again automatically once.
When this option is selected, any time the check is run again automatically, you are charged for the second check.
  1. Validate address if either province or locality matches, even if other fields are flagged as mismatched (optional): When this option is selected, the address is considered validated when the province or locality matches, even if other address fields do not match.
If the addresses provided on the individual’s profile do not include dates, the addresses used for this check are selected at random.
  1. Include forename alias matches from the following sources (optional): When this option is selected, the individual's name is considered validated if the first name or an equivalent spelling is discovered in any of the databases you select. You can choose from the following databases: UK Edited Electoral Roll (ID 101), UK National Identity Registry (ID 245), Experian UK Credit Bureau Credit Database (ID 394), and Experian UK Credit Bureau Electoral Registry (ID 394). To learn more about how GBG ID3global determines equivalent spellings for first names, please speak with your GBG account manager.

What we’ll need

Let us know that you’d like to add a variant of the Electronic identity check with GBG ID3global and which configuration options you’d like to use. We’ll set it up for you.

If you have a direct agreement with GBG ID3global, we’ll also need:

  • The URL for your GBG ID3global API (e.g. https://www.id3global.com/ID3gWS/ID3global.svc?wsdl)
  • A GBG ID3global account set up just for PassFort, and the username of that account
  • The GBG Profile(s) for the jurisdiction(s) for your checks. For each profile, we need the Country of Applicant (the jurisdiction) and the Profile ID.

Learn how to create a GBG ID3global account and get your username and profile IDs.

If you have a direct agreement with GBG ID3global, an error is displayed if the check is run on a profile with a country of address that does not match a Country of Applicant for one of the GBG Profiles you’ve provided.

Testing your configuration

Once the check variant is configured, follow these steps in your demo environment to test whether it's working as expected.

When the check variant is configured to pass on 2+2 results (default configuration):

  1. Does the check pass when a 2+2 result is achieved? To run the test, create any individual profile and run the check variant. If the check passes, it’s working as expected.
When you’re using the Identity number is one of the required fields configuration option, it’s not possible to achieve 2+2 results.
  1. Does the check return a partial match when a 1+1 result is achieved? To run the test when you are using the Identity number is one of the required fields configuration option, create any individual profile with "1+1" as a given name or surname (e.g. "Alex 1+1 Wheeler") and an address located in the US and run the check variant. If the check returns a partial match, it’s working as expected.

    To run the test when you’re not using the Identity number is one of the required fields configuration option, create any individual profile with "1+1" as a given name or surname (e.g. "Alex 1+1 Wheeler") and run the check variant. If the check returns a partial match, it’s working as expected.
  2. Does the check fail when the conditions are not met for a 2+2 result or a 1+1 result? To run the test, create an individual profile with "FAIL" as a given name or surname (e.g. "Alex FAIL Wheeler") and run the check variant. If the check fails, it’s working as expected.

When the check variant is configured to pass on 1+1 results:

  1. Does the check pass when a 1+1 result is achieved? To run the test when you are using the Identity number is one of the required fields configuration option, create any individual profile that has an address located in the US and run the check variant. If the check passes, it’s working as expected.

    To run the test when you’re not using the Identity number is one of the required fields configuration option, create any individual profile and run the check variant. If the check passes, it’s working as expected.
  2. Does the check fail when the conditions are not met for a 1+1 result? To run the test, create an individual profile with "FAIL" as a given name or surname (e.g. "Alex FAIL Wheeler") and run the check variant. If the check fails, it’s working as expected.
Although tests for the Identity number is one of the required fields configuration option are run on individuals with addresses located in the US, individuals can have any country of address when this check is run in the live environment.
In the live environment, an error is displayed when the check is run on a profile with a country of address that isn’t covered by GBG ID3global. This error is not displayed in the demo environment.
The test words are not case-sensitive.

Required and optional profile fields

These are the profile details searched in GBG ID3global’s sources:

Name

Description

First name(s) (personal_details.name.given_names)

Required

The individual’s first and, if applicable, middle names.

Surname (personal_details.name.family_name)

Required

The individual's last name.

Date of birth (personal_details.dob)

Required

The individual’s date of birth.

Addresses (address_history)

Required

The postal code is optional for the following countries: Brazil, China, Hong Kong, India, Luxembourg, Malaysia, Mexico, Romania, Russia, Saudi Arabia, Singapore

The individual’s address history.

Phone number (contact_details.phone_number)

Optional

The individual's phone number.

National identity number (personal_details.national_identity_number)

Optional

This field is required for all countries when the Identity number is one of the required fields configuration option is used

The individual’s national identity number for their registered country.

For more information, see Which national identity numbers can be used?

Passport number (collected_data.documents_metadata)

Optional

GBG only supports sending one non-UK passport number. If there are multiple non-UK passports, we will send the passport that matches the country of address.

The individual's passport number.

Driving licence number (collected_data.documents_metadata)

Optional

We will send one driving licence per country for countries where GBG supports driving licences.

The individual's driving licence number.

Which national identity numbers can be used?

The following national identity numbers can be used:

Country

Type of national identity number

Brazil

Cadastro de Pessoas Fisicas (CPF)

Canada

Social Insurance Number (SIN)

Switzerland

Swiss identity card

Denmark

CPR

Spain

Numero de Identificacion Fiscal (NIF)

Hong Kong

Hong Kong Identity Card (HKID)

Italy

Codice fiscale

Singapore

National Registration Identity Card (NRIC)

United States

Social Security Number (SSN)

South Africa

Smart ID card

ID verification (PassFort collects documents)

How it works

This is the default behaviour for a variant of the ID verification (PassFort collects documents) check with GBG ID3global as the data provider.

You upload the individual's document to PassFort. PassFort submits the document to GBG ID3global who checks for signs of forgery and extracts the customer’s name, date of birth, and, where possible, nationality from the document.

You can upload these documents for the Verify address task:

  • Driving license
  • State ID

You can upload these documents for the Verify identity task:

  • Driving license
  • Passport
  • State ID
The document size limit is 50MB. The following file types are accepted: GIF, JPG, PNG, PDF, TIFF.

PassFort cross-references the extracted data provided by GBG ID3global with the details recorded in the individual’s profile (name, date of birth, and, if available, nationality).

PassFort imports an image of the documents to the task on the profile.

The check passes when all three criteria are met:

  1. The document details obtained from GBG ID3global match the details in the profile.
  2. GBG ID3global confirms the documents are authentic.
  3. GBG ID3global confirms that any additional checks have passed (e.g. police checks or selfie checks).

If the individual’s details do not match the data in GBG ID3global’s sources, the check fails.

Because cross-referencing the individual’s details is an action performed in PassFort and not in GBG ID3global, it’s possible for the check to pass in GBG ID3global but fail in PassFort.

If the individual’s profile doesn’t have data for the required fields, an error is displayed.

If the country of address in the individual’s profile isn’t covered by GBG ID3global, an error is displayed.

To get step-by-step instructions for running this check, see Verify a document.

Configuration options

You can choose from the following configuration options:

  • Check the individual's nationality against the one extracted from the document (optional): When this option is selected, PassFort always cross-references the country of nationality recorded in the individual’s profile against the country of nationality that GBG ID3global extracted from the document. If the country of nationality does not match, the check fails. If the profile does not have a country of nationality, an error is displayed.
  • Require full date of birth (year, month and day) to run the check (optional): When this option is selected, the full date of birth must be provided in the profile to run the check. When deselected, a partial date of birth (i.e. year and month or just year) can be used.

What we’ll need

Let us know that you’d like to add a variant of the ID verification (PassFort collects documents) check with GBG ID3global and whether you’d like to use the Check nationality configuration option. We’ll set it up for you.

If you have a direct agreement with GBG ID3global, we’ll also need:

  • The URL for your GBG ID3global API (e.g. https://www.id3global.com/ID3gWS/ID3global.svc?wsdl)
  • A GBG ID3global account set up just for PassFort, and the username of that account

Learn how to create a GBG ID3global account and get your username.

Testing your configuration

Once the check variant is configured, follow these steps in your demo environment to test whether it's working as expected.

  1. Does the check pass when the identification document is authentic and the extracted document details obtained from GBG ID3global match the details in the profile? To run the test, use the image below as the image of the identification document and run the check variant. If the check passes, it’s working as expected.
  2. Does the check fail when the identification document is not authentic or the extracted document details obtained from GBG ID3global do not match the details in the profile? To run the test, use the image below as the image of the identification document and run the check variant. If the check fails, it’s working as expected.
In the live environment, an error is displayed when the check is run on a profile with a country of address that isn’t covered by GBG ID3global. This error is not displayed in the demo environment.

Required and optional profile fields

These are the profile details matched with the document details extracted by GBG ID3global:

Name

Description

First name(s) (personal_details.name.given_names)

Required

The individual’s first and, if applicable, middle names.

Surname (personal_details.name.family_name)

Required

The individual’s last name.

Date of birth (personal_details.dob)

Required

The individual’s date of birth.

Addresses (address_history)

Required

The individual’s address history.

Nationality (personal_details.nationality)

Optional

This field is required when the Check nationality configuration option is used

The individual’s country of nationality.

If you’re running the check via the API, the ID verification check also uses the following field from the ID check’s documents:

Key name

Description

document_id

Required

The document’s unique identifier in PassFort.

Creating your GBG ID3global account and getting your username and profile IDs

Creating your account and getting your username

First, create a GBG ID3global account for PassFort:

  1. Log in to your GBG ID3global account.
  2. Click the Accounts tab.
  3. Click Add. The Add Account dialog is displayed.
  4. Set the fields as follows:
    1. Name: PassFort
    2. Username: passfort
    3. Email: support@passfort.com
    4. Pin: 0000
  5. Click the Next icon. You're prompted to select the required roles for the account.
  6. Choose to include the role names for everyone@[yourdomain] and profile.admins@[yourdomain].
  7. Click Done.
  8. Click the Accounts tab and select the PassFort account.
  9. Switch Password never expires to ON.
  10. Click Update.

Next, get your username:

  1. Open the account you just created and click Accounts.
  2. Copy the text in the Username field (e.g. PassFort). This is the username we need in Step 5.
  3. Click the Settings tab.
  4. Copy the text in the Domain name field (e.g. passfort.io). This is the domain name we need in Step 5.
  5. Your username is [Username]@[Domain name] (e.g. PassFort@passfort.io).
  6. Send use the username from Step 5 and the password for the account you selected in Step 1. You would have set the password for the account when you created it.

Profile IDs

To get your profile IDs:

  1. Log in to your GBG ID3global account.
  2. Click the Profiles tab.
  3. For each profile you want to add to PassFort:
    1. Click the More icon. More information about the profile is displayed.
    2. Click the Edit icon.
    3. Send us the text in the ID field as well as the region for the profile.


How did we do?


Powered by HelpDocs (opens in a new tab)