iDEAL

For an iDEAL order the following extra details are required:

  • BIC of the chosen bank (the “issuer ID”)
  • URL to redirect the customer to after payment (return_url – optional, but recommended)

The following is an example of an iDEAL request:

POST /v1/orders/ HTTP/1.1
Authorization: Basic aHVudGVyMjo=
Content-Type: application/json

{
  "merchant_order_id": "EXAMPLE001",
  "amount": 995,
  "currency": "EUR",
  "description": "Example iDEAL order",
  "return_url": "https://www.example.com/",
  "transactions": [
    {
      "payment_method": "ideal",
      "payment_method_details": {
        "issuer_id": "INGBNL2A"
      }
    }
  ]
}

Listing of all available issuers for iDEAL

To get a list of all available issuers for iDEAL, do the following request:

GET /v1/ideal/issuers/ HTTP/1.1
Authorization: Basic aHVudGVyMjo=

As a response, you will get something like:

[
  {
    "id": "INGBNL2A",
    "list_type": "Deutschland",
    "name": "Issuer Simulation V3 - ING"
  },
  {
    "id": "RABONL2U",
    "list_type": "Deutschland",
    "name": "Issuer Simulation V3 - RABO"
  }
]