Supported banks
curl --request GET \ --url https://api.ztlpay.io/api/v2/banks/NO/supported \ --header 'Authorization: Bearer <token>'List of supported banks, with known constraints. Due to variations in the PSD2 APIs of the different banks, initiating a payment with certain banks may be subject to some limitations
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Country code, ISO-3166
Example
NOResponses
Section titled “Responses”Successfully retrieved details of supported banks.
A supported bank with constraints and branches
object
Bank BIC code, 8 digits
Bank constraints on top level. Present on banks without branches, and if constraints are the same for all branches. If the constraints are different, constraints will be contained within each branch in the branches list.
object
The maximum number of transactions that can be bundled in the same basket.
The maximum length of information fields such as debtor name or creditor address.
The maximum length of unstructured remittance information (i.e., payment message) that may be sent in the initiate payment request.
The maximum range for retrieving account entries for an account.
If true, then the bank requires SCA for cancelling payments. If false, cancelling payments do not require SCA.
Regex for allowed symbols in information fields such as debtor name or remittance info.
Additional information about ais date range
The maximum number of transactions that can be bundled in a bulk payment.
Bank name
Platform the PSD2 solution is operating on (e.g. EVRY in Norway, SDC). Included if we have this in our internal system
Alliance of the bank, Included if we have this in our internal system
object
Name of the branch
The branch name that should be sent to us when creating consent
Constraints applicable to this specific branch. Contained only if constraints are different for each branch.
object
The maximum number of transactions that can be bundled in the same basket.
The maximum length of information fields such as debtor name or creditor address.
The maximum length of unstructured remittance information (i.e., payment message) that may be sent in the initiate payment request.
The maximum range for retrieving account entries for an account.
If true, then the bank requires SCA for cancelling payments. If false, cancelling payments do not require SCA.
Regex for allowed symbols in information fields such as debtor name or remittance info.
Additional information about ais date range
The maximum number of transactions that can be bundled in a bulk payment.
Example
[ { "bic": "DNBANOKK", "constraints": { "maxBasketSize": 20, "maxInformationFieldLength": 35, "maxUnstructuredRemittanceInfoLength": 108, "aisMaxDateRangeMonths": 12, "cancelSCARequired": true, "validInformationFieldCharactersPattern": "[A-ZÆØÅa-zæøå0-9\\\\D]", "aisMaxDateRangeNote": "Supports up to 24 months if consent age < 1h", "maxBulkSize": 20 }, "countryCode": "NO", "name": "DNB BANK ASA", "platform": "EVRY", "bankAlliance": "SPAREBANK_1", "supportedProducts": [ "PAYMENT_DOMESTIC" ], "branches": [ { "name": "District", "branch": "DISTRICT", "constraints": { "maxBasketSize": 20, "maxInformationFieldLength": 35, "maxUnstructuredRemittanceInfoLength": 108, "aisMaxDateRangeMonths": 12, "cancelSCARequired": true, "validInformationFieldCharactersPattern": "[A-ZÆØÅa-zæøå0-9\\\\D]", "aisMaxDateRangeNote": "Supports up to 24 months if consent age < 1h", "maxBulkSize": 20 } } ] }]Bad request
object
Unique RequestId, please provide this Id in case of support requests
The underlying reason for the error
Example
{ "ztlRequestId": "3a797348-ef0c-4f52-b821-fdfcdb98c4d9", "message": "Invalid account"}Headers
Section titled “Headers”Unique RequestId, please provide this Id in case of support requests
Example
3a797348-ef0c-4f52-b821-fdfcdb98c4d9