Bank Account
Add Bank Account
• Currency is mandatory and should be only EUR.
• Bic is mandatory and should comply general Bic rules.
AAAA BB CC DDD
First 4 characters - bank code (only letters)
Next 2 characters - ISO 3166-1 alpha-2 country code (only letters)
Next 2 characters - location code (letters and digits) (passive participant will have "1" in the second character)
Last 3 characters - branch code, optional ('XXX' for primary office) (letters and digits)
• Country code is mandatory and should be in Alpha3Code format.
• IBAN is mandatory.
• The prefix of IBAN and the country code should specify the same country.
• IBAN should belong to one of the SEPA Credit Transfer accepting countries, which are provided as below:
Andorra
Austria
Belgium
Bulgaria
Croatia
Cyprus
Czech Republic (Czechia)
Denmark
Estonia
Finland
France
Germany
Greece
Hungary
Iceland
Ireland
Italy
Latvia
Liechtenstein
Lithuania
Luxembourg
Malta
Monaco
Netherlands
Norway
Poland
Portugal
Romania
Slovakia
San Marino
Slovenia
Spain
Sweden
Switzerland
United Kingdom of Great Britain and Northern Ireland
Vatican City (Holy See)
• Every client id in the client id list should be unique and should exist in the system.
• Each client in the list should not have any bank account that has an IBAN same as the requested IBAN.
• Each client in the list should have at least one active tax residency address or residential address.
• Each client in the list should have at least one address inside SEPA Credit Transfer accepting countries.
• Each client in the list should have at least one address that specifies the same country as the prefix of the IBAN or IBAN should be from Germany.
Add Document
• Bank account should exist in the system and its status should not be deleted.
• ValidFrom and ValidUntil fields should be dates and format should be yyyy-MM-dd.
• ValidUntil field cannot be a date before now.
• ValidFrom cannot be later than ValidUntil.
• Document should be max 5MB.
NOTE: OAuth2 is a protocol that allows applications to request access tokens from a Security Token Service (or Authorization Service) and use them to communicate with APIs. This delegation reduces complexity in both the client applications and the APIs since authentication and authorization can be centralized.
Remove Document
• Bank account should exist in the system.
NOTE: Different terms can be denoted such as Security Token Service (STS), Identity Provider, Authorization Server, etc.
Update Bank Account Status
• Bank account should exist in the system.
• If bank account status and the requested status is initial, conflict occurs.
• If account status is deleted and the requested status is active, conflict occurs.
• If account status is initial or deleted, status cannot be updated as suspended or deleted.
• If account status is deleted and the requested status is initial, conflict occurs.
Validate Bank Account
• Bank account should exist in the system.
• Bank account should have documents uploaded.
Get Bank Accounts
• Page number should be equal or bigger then 1.
• Records per page should be between 10 and 1000.
Get Bank Account Transactions
• Bank account should exist in the system.
• Page number should be equal or bigger then 1.
• Records per page should be between 10 and 1000.