Bank/Country Info

Getting Bank/Account Information
Functions in this group retrieve information about credit institutes and allow checking of bank code/account id combinations. These functions load the appropriate checker plugins for selected countries.
AB_BANKINFO *	AB_Banking_GetBankInfo (AB_BANKING *ab, const char *country, const char *branchId, const char *bankId)
int	AB_Banking_GetBankInfoByTemplate (AB_BANKING *ab, const char *country, AB_BANKINFO *tbi, AB_BANKINFO_LIST2 *bl)
AB_BANKINFO_CHECKRESULT	AB_Banking_CheckAccount (AB_BANKING *ab, const char *country, const char *branchId, const char *bankId, const char *accountId)
int	AB_Banking_CheckIban (const char *iban)
int	AB_Banking_MakeGermanIban (const char *bankCode, const char *accountNumber, GWEN_BUFFER *ibanBuf)

Getting Country Information
Functions in this group retrieve information about countries (name, code, numeric code).
const AB_COUNTRY *	AB_Banking_FindCountryByName (AB_BANKING *ab, const char *name)
const AB_COUNTRY *	AB_Banking_FindCountryByLocalName (AB_BANKING *ab, const char *name)
const AB_COUNTRY *	AB_Banking_FindCountryByCode (AB_BANKING *ab, const char *code)
const AB_COUNTRY *	AB_Banking_FindCountryByNumeric (AB_BANKING *ab, int numid)
AB_COUNTRY_CONSTLIST2 *	AB_Banking_ListCountriesByName (AB_BANKING *ab, const char *name)
AB_COUNTRY_CONSTLIST2 *	AB_Banking_ListCountriesByLocalName (AB_BANKING *ab, const char *name)

Detailed Description

Function Documentation

AB_Banking_CheckAccount()

AB_BANKINFO_CHECKRESULT AB_Banking_CheckAccount	(	AB_BANKING *	ab,
		const char *	country,
		const char *	branchId,
		const char *	bankId,
		const char *	accountId
	)

This function checks whether the given combination represents a valid account. It loads the appropriate bank checker module and lets it check the information.

Parameters

ab	AqBanking main object
country	ISO country code ("de" for Germany, "at" for Austria etc)
branchId	optional branch id (not needed for "de")
bankId	bank id ("Bankleitzahl" for "de")
accountId	account id

AB_Banking_CheckIban()

int AB_Banking_CheckIban

(

const char *

iban

)

Checks whether a given international bank account number (IBAN) is valid or not.

Returns

0 if valid, 1 if not and -1 on error

Parameters

iban	IBAN (e.g. "DE88 2008 0000 09703 7570 0")

AB_Banking_FindCountryByCode()

const AB_COUNTRY* AB_Banking_FindCountryByCode	(	AB_BANKING *	ab,
		const char *	code
	)

Searches for information about a country by its ISO country code (e.g. "DE"=Germany, "AT"=Austria etc). The code may contain jokers ("?") and wildcards ("*") and is case insensitive.

AB_Banking_FindCountryByLocalName()

const AB_COUNTRY* AB_Banking_FindCountryByLocalName	(	AB_BANKING *	ab,
		const char *	name
	)

Searches for information about a country by its local name (in the currently selected language). The name may contain jokers ("?") and wildcards ("*") and is case insensitive.

AB_Banking_FindCountryByName()

const AB_COUNTRY* AB_Banking_FindCountryByName	(	AB_BANKING *	ab,
		const char *	name
	)

Searches for information about a country by its international name (in English). The name may contain jokers ("?") and wildcards ("*") and is case insensitive.

AB_Banking_FindCountryByNumeric()

const AB_COUNTRY* AB_Banking_FindCountryByNumeric	(	AB_BANKING *	ab,
		int	numid
	)

Searches for information about a country by its ISO numeric code (e.g. 280=Germany etc).

AB_Banking_GetBankInfo()

AB_BANKINFO* AB_Banking_GetBankInfo	(	AB_BANKING *	ab,
		const char *	country,
		const char *	branchId,
		const char *	bankId
	)

This functions retrieves information about a given bank. It loads the appropriate bank checker module and asks it for information about the given bank. The caller is responsible for freeing the object returned (if any) by calling AB_BankInfo_free.

Parameters

ab	AqBanking main object
country	ISO country code ("de" for Germany, "at" for Austria etc)
branchId	optional branch id (not needed for "de")
bankId	bank id ("Bankleitzahl" for "de")

AB_Banking_GetBankInfoByTemplate()

int AB_Banking_GetBankInfoByTemplate	(	AB_BANKING *	ab,
		const char *	country,
		AB_BANKINFO *	tbi,
		AB_BANKINFO_LIST2 *	bl
	)

This function retrieves information about banks. It loads the appropriate bank checker module and asks it for a list of AB_BANKINFO objects which match the given template. Empty fields in this template always match. Service entries (AB_BANKINFO_SERVICE) are not compared. Matching entries are added to the given list. The caller is responsible for freeing the objects returned (if any) by calling AB_BankInfo_free (or by calling AB_BankInfo_List_freeAll).

Parameters

ab	AqBanking main object
country	ISO country code ("de" for Germany, "at" for Austria etc)
tbi	template to compare against
bl	list to which matching banks are added

AB_Banking_ListCountriesByLocalName()

AB_COUNTRY_CONSTLIST2* AB_Banking_ListCountriesByLocalName	(	AB_BANKING *	ab,
		const char *	name
	)

Returns a list of informations about countries whose local name (in the currently selected language) matches the given argument. The list returned must be freed using AB_Country_ConstList2_free() by the caller. The elements of that list are all const. The name may contain jokers ("?") and wildcards ("*") and is case insensitive.

AB_Banking_ListCountriesByName()

AB_COUNTRY_CONSTLIST2* AB_Banking_ListCountriesByName	(	AB_BANKING *	ab,
		const char *	name
	)

Returns a list of informations about countries whose international name (in English) matches the given argument. The list returned must be freed using AB_Country_ConstList2_free() by the caller. The elements of that list are all const. The name may contain jokers ("?") and wildcards ("*") and is case insensitive.

AB_Banking_MakeGermanIban()

int AB_Banking_MakeGermanIban	(	const char *	bankCode,
		const char *	accountNumber,
		GWEN_BUFFER *	ibanBuf
	)

Create an IBAN from German bank code and account number.