Skip to main content

Get the iDeal banks list

This method returns the list of all banks handled by iDeal. It will allow you to create your own iDeal payment page using also the Server-to-server token creation with initial payment request or Server-to-server payment request.

  • URL syntax: /api/v2/merchant/payment-method/ideal/banks
  • Method: GET

Response parameters

NameTypeMandatoryDescription
classstringYThe type of object which is being returned. In this case it will be ideal_banks.
updatedunix timestampYThis is used to check whether the list of banks has been updated.
banksarrayYA list of iDeal banks
bank.idintegerYThe iDeal bank reference. This value is to be used in payment requests to indicate which bank should be used.
bank.namestringYThe name of the bank.
bank.countrystringYThe country of the bank.

Example response

{
"class": "ideal_banks",
"updated": 1625780220,
"banks": [
{
"class": "bank",
"id": 1,
"name": "Issuer Simulation V3 - ING",
"country": "Nederland"
},
{
"class": "bank",
"id": 2,
"name": "Issuer Simulation V3 - RABO",
"country": "Nederland"
},
{
"class": "bank",
"id": 3,
"name": "Sandbox stub issuer",
"country": "Nederland"
}
]
}