Global Lookup

You must have the correct licence to use the Global Lookup module.

You can use Bank Wizard to look up bank/branch and, if you have the correct licence, SWIFT data for the majority of countries. This includes countries that are not currently supported for validation, for example, Brazil, China and United Arab Emirates.

The lookup data is a sub-set of the data provided for fully supported countries and it is included in a separate database table file. It includes the basic branch address and BIC information only.

To validate account or branch details, you must implement the specific country. You cannot use Global Lookup to validate account details, validate or decompose an IBAN, or transpose or modulus check account details.

You implement Global Lookup in the same way as you would implement any standard validation country. You send Bank Wizard the input strings and perform the lookup. Bank Wizard performs simple validation on the input strings and then returns condition codes and data that you process as appropriate for your business.

The 2 character country code for the Global Lookup module is ZY.

You can also perform the standard keyword search on the lookup data. You can enter up to 3 key words to search the whole ZY data.

Input strings

For Global Lookup, the strings you can use to look up data are:

BWI_ZY_BANK_BRANCH_CODE

This is the branch identifier. This must be between 1 and 10 alphanumeric characters.
If the country uses separate bank and branch codes, combine both codes and supply in this field. For example for Portugal, you would supply one 8 digit code.
Bank Wizard makes sure the input string is the correct length and does not contain any non-alphanumeric characters, such as / and -

BWI_ZY_COUNTRY_CODE

This is the 2 character country code. Supply this to lookup details in a specific country. Leave this blank to search all countries.

BWG_BIC_STRING

This is the BIC. Supply this to look for a specific BIC in the data.

Since this is performing a lookup and not a check, you should not set the BIC_CHECK flag.

Data returned

When using Global Lookup, the basic branch data returned is:

BWI_ZY_BANK_BRANCH_CODE_FIELD Bank-branch code. This may be the same for multiple branches (main and sub-brnaches).
BWI_ZY_BANK_NAME Bank or institution name
BWI_ZY_TELEGRAPHIC_NAME Telegraphic name. This is used for Fedwire.
BWI_ZY_OTHER_NAME Alternative names of the bank
BWI_ZY_STREET_ADDRESS Street
BWI_ZY_BRANCH_NAME Branch name
BWI_ZY_POST_CODE Postcode
BWI_ZY_CITY City
BWI_ZY_LOCATION Address location
BWI_ZY_COUNTRY Country
BWI_ZY_COUNTY_PROVINCE_STATE County, Province, or State
BWI_ZY_ISO_COUNTRY_CODE 2 character ISO country code
BWI_ZY_IBAN_COUNTRY_CODE 2 character country identifier used for IBAN purposes. This is not always the same as the ISO Country Code

Conditions returned

Global Lookup returns the following condition codes:

Error conditions

BWG_E_BANK_BRANCH_CODE_FORMAT (1) BWG_E_NO_BRANCH (6) BWI_ZY_COUNTRY_CODE_FORMAT (64)

Information conditions

   
BWG_I_BIC_MATCH_SWIFT_BRANCH (3) BWG_I_BIC_MATCH_SWIFT_ROUTING (4) BWG_I_BIC_MATCH_BRANCH (5)