Function supported_countries

Example:
supported_countries("IBAN AND some_BICs AND (account_validated OR bankcode_validated)", "DE", "benutzername", "passwort") returns, in German ("DE"), a list of countries which are supported by the SOAP interface such that IBANs can be calculated, BICs (possible more than one BIC candidate) are returned for those bank codes for which a BIC is defined, and the domestic account number or the bank code are validated (or both).

Purpose: Informs which countries are currently supported by the SOAP interface, and what their names are in a given language. You may specify what conditions must be met for a country to be considered "supported".

Input Parameters:

• supported_condition: xsd:string
  Your definition of "supported", that is, a condition which countries must meet to be listed. You may use the following keywords, and you can combine them with parentheses, AND, and OR:
  • IBAN: IBANs can be calculatede for this country.
  • unique_BIC: returns a unique BIC for any bank code for which a BIC is defined.
  • some_BICs: returns one or more BIC candidates for any bank code for which a BIC is defined. If more than one BIC candidate is returned, you need to find out yourself which one to use. However, the most likely one will be listed first. Countries which fulfil not just the condition some_BICs but even the condition unique_BIC are considered to also fulfil some_BICs.
  • name_based_BICs: like for "some_BICs", none, one, or several BIC codes could be returned. However, unlike "some_BICs", these BIC candidates are not taken directly from a directory that maps bank codes to BICs, but they have been determined by joining two directories based on the bank names. This makes the BIC information slightly less reliable. Countries which fulfil "some_BICs" are also considered to fulfil "name_based_BICs". That is, if you require that at least "name_based_BICs" is fulfilled, you will not exclude the better-supported countries fulfilling "some_BICs" or "unique_BIC".
  • account_validated: for all domestic account numbers which contain a check sum, this check sum is validated.
  • bankcode_validated: the bank code is validated by looking it up in a directory of bank codes.

  If you leave the parameter "supported_condition" empty, the default condition "IBAN AND some_BICs AND (account_validated OR bankcode_validated)" is used.

• language: xsd:string
  The two-letter country code for the desired language (for the list of country names); instead of the two-letter code, you may also use a number from this list:
  • English = 0 or EN
  • German = 1 or DE
  • Dutch = 3 or NL
  • Polish = 4 or PL
  • French = 5 or FR
  • Spanish = 6 or ES
  • Italian = 7 or IT
  • Turkish = 8 or TR
  • Croatian = 9 or HR
  • Serbian = 10 or RS

• user: xsd:string
  The user name with which you log in to iban-bic.com.
• password: xsd:string
  Your password.

Output Fields:

tns:CountryResStruct with the following fields:

• result: 'OK' or an error message.
• supported_countries: List of 2-letter country codes for all supported countries.
• country_names: List of the supported countries' names (in the specified language).
• balance: Your account balance (number of remaining transactions).

This function in action

Our CMS composes the following table by using several calls of the function "supported_countries". Therefore, we don't have to manually adjust the table; it always keeps up to date automatically whenever the SOAP interface starts supporting another country.