curl --request GET \
--url 'https://api.hopae.com/connect/v2/providers/idin/banks' \
--user '{appId}:{appSecret}'
{
"banks": [
{ "bic": "ABNANL2A", "name": "ABN AMRO" },
{ "bic": "INGBNL2A", "name": "ING" }
],
"lastUpdated": "2026-10-28T09:00:00.000Z"
}
Provider-specific
List iDIN Banks
Get the Dutch banks an iDIN verification accepts as userInput.presetBank.
GET
/
providers
/
idin
/
banks
curl --request GET \
--url 'https://api.hopae.com/connect/v2/providers/idin/banks' \
--user '{appId}:{appSecret}'
{
"banks": [
{ "bic": "ABNANL2A", "name": "ABN AMRO" },
{ "bic": "INGBNL2A", "name": "ING" }
],
"lastUpdated": "2026-10-28T09:00:00.000Z"
}
Returns the Dutch banks an iDIN verification accepts. Show each
name to the user, then send the chosen bic as userInput.presetBank in Create Verification. idin is the provider.id that Get Connections lists for the iDIN connection.
The list is fetched with the iDIN credentials of your app’s oldest activated iDIN connection on the app’s environment. The workflow is not consulted.
- Sandbox app: your connection’s iDIN credentials, or Hopae’s demo account (iDIN’s simulator banks) when it holds none, as after Demo activate.
- Production app: the iDIN account Hopae sets up when it activates the connection.
lastUpdated says when it was fetched from iDIN.
Headers
string
required
Basic <base64(appId:appSecret)>. See Authentication.Response
object[]
required
string
required
When the list was fetched from iDIN (ISO 8601). It is cached for up to 24 hours.
curl --request GET \
--url 'https://api.hopae.com/connect/v2/providers/idin/banks' \
--user '{appId}:{appSecret}'
{
"banks": [
{ "bic": "ABNANL2A", "name": "ABN AMRO" },
{ "bic": "INGBNL2A", "name": "ING" }
],
"lastUpdated": "2026-10-28T09:00:00.000Z"
}
Errors
| HTTP | Code | When |
|---|---|---|
| 400 | VALIDATION_MISSING_PARAMETER | The production iDIN connection holds no iDIN credentials. Contact Hopae: the connection needs fixing, not the request |
| 401 | AUTH_INVALID_CREDENTIALS | Wrong App ID or App Secret |
| 403 | PROVIDER_NOT_ACTIVATED | No iDIN connection is activated on your app’s environment. Activate one in the Console |
| 502, 503 | iDIN refused or failed the request, for example because of an invalid merchant token. Retry later; contact Hopae if it persists |
Authorizations
Basic base64(appId:appSecret). See Authentication.