Input strings

The input strings you use are determined by the format of the country's account details. You enter these strings using BWISetString and Query them using BWIGetString.

In all of these strings CC is the ISO country code.

Account number countries

For countries that either only have an account number or use the IBAN for all transactions, the string is:

You cannot carry out branch level checks on these countries.

Two part account number countries

For countries that have a two part account number and a bank code, the strings are:

Bank-branch code countries

For countries that have one bank-branch code, the strings are:

ClosedReturning Netherlands Bank Identifiers

You can call the hook BWI_NL_HOOK_BANK_IDENTS to return the Netherlands Bank identifiers. These 4-character codes are packed into strings containing a maximum of 16 identifiers, separated by a space. For example:

ABNA ABPS ABPT ACDO ACDS ACHM AEGO AFSG AHBK AIBT AKBK

For the first call, call BWIHOOK with BWI_V_PAR1 set to zero. After this call, BWI_V_PAR2 is set to the total number of identifiers and BWI_V_PAR3 is set to the number of lines these identifiers are packed into.

After this first call, do not change BWI_V_PAR1.

You can now access each line of identifiers by calling BWIGetString with an item of BWI_V_PAR1.

For example:

  1. Make sure the handle parameter number is zero and set a current line variable to zero:

    2. BWISetValue(h,BWI_V_PAR1,0);

    current_line=0

  2. Set the number of lines to a dummy (high) value so that the loop block will work correctly first time through:

    3. num_line = 99

  3. If the current line is more than the number of lines of identifiers, end. Otherwise continue.
  4. Increase the value of the current line variable by 1.
  5. Call the hook.

    6. BWIHook(h,BWI_NL_HOOK_BANK_IDENTS)

  6. If this is the first time round the loop, set num_line to the number of lines of identifiers there are:

    7. If (current_line==1) BWIGetValue(h,BWI_V_PAR3,num_line)

  7. Get the current line.

    8. BWIGetString(h,BWI_V-PAR1,IDs)

  8. Deal with the details as required.
  9. Repeat from step 2.
ClosedReturning UK Faster Payments and alternative branch data

(For the United Kingdom, you can use hooks to access alternative branch data and, if you have the correct licence, Faster Payments data. The information condition BWI_UK_ACC_ALTERNATE_INFO is returned if there is alternative branch data.

Bank and branch code countries

For countries that have both a bank and a branch code, the strings are:

Iceland

For Iceland the strings you can enter are:

Sub-branches

For countries that support sub-branches, call BWINext with item=BWI_N_BRANCH to access the details of further branches. To check if branch data is available, call BWIGetValue with item=BWI_V_DATA. If this returns 1, then branch data is available.

For Germany, the Republic of Ireland and the United Kingdom, you can also retrieve BWI_CC_NUM_BRANCHES. This shows the number of branches that share the same bank-branch code.

Examples

ClosedAccount validation example

BWICreateHandle(h)

BWISetString h BWI_IE_SORT_CODE "932078"

BWISetString h BWI_IE_ACCOUNT_NO "20716228"

BWICheck(h)

/*
Iterate through conditions
Access any strings that may be required, for example:
*/

len = sizeof (str)

BWIGetString h BWI_IE_BANK str len

BWIFree(h)
ClosedAccess sub-branch example

This example assumes a validation has already been performed.

BWIGetValue h BWI_UK_NUM_BRANCHES num

While num 0

  BWINext h BWI_N_BRANCHES

  len = sizeof(str)

  BWIGetString h BWI_UK_BANK str len

  print str

End while
Related Topics Link IconSee also