Directory

Retrieve a listing of all the banks and their identifiers.

Request

POST https://api.cm.com/ibancheck/v1.0/directory
{
  "merchant_token": "3c01abeb-b031-4fea-9f2d-c55c283cd78e"
}

Parameters

ParameterDescription
merchant_tokenA GUID string that is unique and private to you as a merchant. Do not share this key, keep it safe. Example 283b1550-ed02-4aee-8529-38a8ae90f10e

Response

[
  {
    "country": "string",
    "issuers": [
      {
        "issuer_id": "RABONL2U",
        "issuer_name": "Rabobank"
      }
    ]
  }
]

📘

Note that this list is different from the list of banks as returned by iDIN.

Parameters

ParameterDescription
countryThe readable name of the country.
issuer_idAn 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_nameThe name of the issuing bank intended for display purposes. Used as the content of in the HTML dropdowns.

Response codes

HTTP statusDescription
200List of banks
400Invalid request
403Authorization required