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:

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 -

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.

BIC

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

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)
Related Topics Link IconSee also