Unzer
search

    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.