Directory
Retrieve a listing of all the banks and their identifiers. The result is grouped by country. It is encouraged to cache this list, but you should refresh the list at least once a day. It may never be older than 7 days. You should not manipulate this list yourself.
Request
POST https://api.cm.com/idin/v1.0/directory
{
"merchant_token": "3c01abeb-b031-4fea-9f2d-c55c283cd78e"
}
Parameters
Parameter | Description |
---|---|
merchant_token | a guid string that is unique and private to you as a merchant. Do not share this key, keep it safe. Example 3c01abeb-b031-4fea-9f2d-c55c283cd78e |
Response
[
{
"country": "string",
"issuers": [
{
"issuer_id": "RABONL2U",
"issuer_name": "Rabobank"
}
]
}
]
Parameters
Parameter | Description |
---|---|
country | The readable name of the country. |
issuer_id | An identifier for the bank. Used as the value of the in bank selector dropdowns. The end user selects a value and iDIN will direct the end user to that bank, so that the user can identify himself. Has the pattern /[A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}/ |
issuer_name | The name of the issuing bank intended for display purposes. Used as the content of in the HTML dropdowns. |
Response codes
HTTP status | Description |
---|---|
200 | List of banks. |
400 | Invalid request. See message for details. |
403 | Authorization required. |
500 | Server error. See message for details. |
503 | Service unavailable. See message for details. |
Updated 6 months ago
What’s Next