Unzer

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

Step 1: Create a Payment Type resource
server side

Data for the iDEAL payment:

Payment data Description
bic (optional) The BIC of the bank selected by the customer

Banks supported by iDEAL in the production environment:

Bank name Bank code
ABN AMRO ABN_AMRO
ASN Bank ASN_BANK
BUNQ BUNQNL2A
ING ING
Knab Bank KNAB_BANK
Rabo Bank RABOBANK
Regio Bank SNS_REGIO_BANK
SNS Bank SNS_BANK
Triodos Bank TRIDIOS_BANK
Van Lanschot Bankiers VAN_LANSCHOT_BANKIERS

Banks supported by iDeal in the sandbox environment:

Bank name Bank code
ING INGBNL2A
Rabo Bank RABONL2U

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.