IBAN Structure Directory
IBAN Structure, containing information about the ISO IBAN formats registered by countries that adopted IBANs in their payment systems.
IBAN Structure dynamic configuration is used during IBAN deconstruction by IPF CSM Reachability Service. The dynamic configuration of IBAN Structure can be populated through ingestion of different files based on the SWIFTRef portfolio subscribed to by a client implementation.
| Sr. No. | Industry Data File | SWIFTRef Version | Directory Subscription | File Format | File Type (Full / Delta) |
|---|---|---|---|---|---|
1 |
IBAN Structure |
Legacy |
BIC Directory |
TXT, XML |
Full, Delta |
2 |
FORMATS-ALL |
Evolved |
Payments Directory |
XML, ZIP (XML) |
Full, Daily Delta, Monthly Delta |
3 |
FORMATS-CTRY |
Evolved |
Identifiers Directory |
XML, ZIP (XML) |
Full, Daily Delta, Monthly Delta |
Iban Structure Directory Data Structure
DPS SETTING_TYPE = "ibanstructure"
| Iban Structure property | Optionality | Description |
|---|---|---|
ibanCountryCode |
M |
The country which has issued the IBAN |
ibanCountryCodePosition |
M |
Position of Iban Country Code |
ibanCountryCodeLength |
M |
Size of Iban country Code |
ibanCheckDigitsPosition |
M |
The position of check digit values in the IBAN (for given country) |
ibanCheckDigitsLength |
M |
The length of check digit values on the IBAN for given country |
bankIdentifierPosition |
M |
Position of Bank Identifier |
bankIdentifierLength |
M |
Size of Bank Identifier |
branchIdentifierLength |
M |
Size of Branch identifier |
ibanNationalIdLength |
M |
Size of Iban National ID |
accountNumberLength |
M |
Size of Account Number |
accountNumberPosition |
M |
Position of Account Number |
ibanTotalLength |
M |
Total Size of Iban |
ibanNationalIdType |
O |
Type of the IBAN National Id |
ibanNationalIdPosition |
O |
Position of the IBAN National Id |
Searchable Fields
Searchable fields for Processing Entity are:
-
identifier
-
identifierType
-
identifierSubType
-
country
Indexes
DPS v2 provides an option to configure indexes for each setting. Default indexes for IBAN Structure Settings are:
ipf.dps.mongodb.index-config.ibanstructure {
index-1 = ["status:ASC"]
index-2 = ["processingEntity:ASC"]
index-3 = ["values.payload.ibanCountryCode:ASC"]
index-4 = ["payload.ibanCountryCode:ASC"]
index-5 = ["lastUpdatedAt:ASC"]
}This can be overridden or updated. Just note that when the field is under payload, you need to provide an index like: index-x = ["values.payload.fieldX:ASC"].
Field processingEntity is added in to the setting search so for better performances is recommended that index for processingEntity is created.