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:
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.