Accept iDeal with a server-side-only integration

Build your own payment form to add iDEAL payment to the checkout page

Overview

The iDEAL payment method doesn’t require any input from the customer on your website. Optionally, you can include a bank selection control for the customer to pre-select their bank when making the payment. You can see an example of iDEAL bank selection component on our demo page.

Before you begin

• Check the basic integration requirements.
• Familiarize yourself with the general Server-side-only integration guide.

Step 1: Create a Payment Type resource [server side]

Data for the iDEAL payment:

Banks supported by iDEAL:

When creating the payment type iDEAL, you need to send a request to the Unzer API. The response will contain an id , this is later referred to as typeId. You will need this typeId to perform the transaction. As mentioned before bic is optional.

POST: https://api.unzer.com/v1/types/ideal/
Body:
{
  "bic" : "INGBNL2A"
}

$unzer = new UnzerSDK\Unzer('s-priv-xxxxxxxxxx');

$ideal = (new UnzerSDK\Resources\PaymentTypes\Ideal())->setBic('INGBNL2A');
$ideal = $unzer->createPaymentType($ideal);

Ideal ideal = new Ideal();
ideal.setBic("INGBNL2A");

Unzer unzer = new Unzer(new HttpClientBasedRestCommunication(), "s-priv-xxxxxxxxxx");
ideal = unzer.createPaymentType(ideal);

The response looks similar to the following example:

{
    "id": "s-idl-obig4czju5hc",
    "method": "ideal",
    "recurring": false,
    "geoLocation": {
        "clientIp": "127.0.0.1",
        "countryIsoA2": "NL"
    },
    "bic": "INGBNL2A"
}

For more details on iDeal payment type creation, see API reference.

Next steps

The next steps are the same as for the UI components integration, check Accept Post Finance Card with UI Components from Step 2 onwards.