iDEAL

ideal

iDEAL is an e-commerce payment system used in the Netherlands, based on online banking. This payment method is by far the most popular method for online payments in the Netherlands, and it allows customers to buy on the Internet using direct online transfers from their bank account.

Bear in mind, that iDEAL doesn’t allow recurring payments.

User Interface

If you want integrate iDEAL, HiPay provides the following user interface on the Hosted Payments and Hosted Fields.

Issuing banks

An Issuer is the bank of the customer (payer). The Issuer allows its customers to pay with iDEAL via their own mobile banking app or their internet banking environment.

Here you have the parties that have a licence for iDEAL for the role of Issuer and their BIC code.

ISSUING BANK BIC Code
ABN AMRO ABNANL2A
ASN Bank ASNBNL21
bunq BUNQNL2A
ING Bank INGBNL2A
Knab KNABNL2H
Moneyou MOYONL21
Rabobank RABONL2U
Regiobank RBRBNL21
SNS Bank SNSBNL2A
Svenska Handelsbanken HANDNL2A
Triodos Bank TRIONL2U
Van Lanschot FVLBNL22

Integration

Hosted Payments
Hosted Fields
Hosted Page
Order API
Hosted Payments

User Experience

      1. Choice of iDEAL as payment method (Hosted Payments on the merchant’s website)
      2. Choice of the issuing bank (Hosted Payments on the merchant’s website)
      3. Redirection and Payment (issuing bank’s website)
      4. Confirmation page display  (merchant’s website)

Integration

With this integration you are in charge of redirecting the customer to the issuing bank’s website, once the customers clicks on the payment button. The hosted payments will take care of displaying the ideal payment method and the list of the issuer banks.

To display the Hosted Payments you will need to integrate the Javascript SDK and the ORDER API to redirect the customer to the issuing bank’s website.

Here you have the mandatory parameters of the ORDER API:

payment_product : iDEAL

orderid : unique order id. Ex: ORDER_1583157210

description : order short description. Ex. Summer Sales

amount : Total order amount. Ex: 9.99

currency : Order ISO 4217 three-character currency code. Ex: EUR

Specific to iDEAL

issuer_bank_id: This is the Business Identifier Code (BIC) of the customer’s issuer bank. Ex. SNSBNL2A

Endpoints

Stage: https://stage-secure-gateway.hipay-tpp.com/rest/v1/order

Production: https://secure-gateway.hipay-tpp.com/rest/v1/order

Make sure you have configured your HiPay account and the redirection urls before using the Order API.

Important ! To have better insights of your payments you can leverage HiPay’s platform data management. To do so, we strongly recommend to send as much data as possible, as the basket and the customer information. Here you have all the parameters of the API.

Hosted Fields

User Experience

      1. Choice of iDEAL as payment method (merchant’s website)
      2. Choice of the issuing bank (Hosted Fields on the merchant’s website )
      3. Redirection and Payment (issuing bank’s website)
      4. Confirmation page display  (merchant’s website)

Integration

With this integration you are in charge of displaying the choice of ideal and redirecting the customer to the issuing bank’s website, once the customers clicks on the payment button.  The hosted fields will take care of displaying the list of the issuer banks.

To display the Hosted Fields you will need to integrate the Javascript SDK and the ORDER API to redirect the customer to the issuing bank’s website.

 Here you have the mandatory parameters of the ORDER API:

payment_product : iDEAL

orderid : unique order id. Ex: ORDER_1583157210

description : order short description. Ex. Summer Sales

amount : Total order amount. Ex: 9.99

currency : Order ISO 4217 three-character currency code. Ex: EUR

Specific to iDEAL

issuer_bank_id: This is the Business Identifier Code (BIC) of the customer’s issuer bank. Ex. SNSBNL2A

Endpoints

Stage: https://stage-secure-gateway.hipay-tpp.com/rest/v1/order

Production: https://secure-gateway.hipay-tpp.com/rest/v1/order

Make sure you have configured your HiPay account and the redirection urls before using the Order API.

Important ! To have better insights of your payments you can leverage HiPay’s platform data management. To do so, we strongly recommend to send as much data as possible, as the basket and the customer information. Here you have all the parameters of the API.

Hosted Page

User Experience

      1. Choice of iDEAL as payment method (merchant’s website or Hosted Page)
      2. Choice of the issuing bank (Hosted Page)
      3. Redirection and Payment (issuing bank’s website)
      4. Confirmation page display (merchant’s website)

Integration

With this integration HiPay will be in charge of displaying the payment method and the list of banks.

In order to do so, you need to request a Hosted Page. Here you have the mandatory parameters of the HPAYMENT API:

payment_product_list : iDEAL

orderid : unique order id. Ex: ORDER_1583157210

description : order short description. Ex. Summer Sales

amount : Total order amount. Ex: 9.99

currency : Order ISO 4217 three-character currency code. Ex: EUR

Endpoints

Stage: https://stage-api.hipay.com/v1/hpayment

Production: https://api.hipay.com/v1/hpayment

Make sure you have configured your HiPay account and the redirection url before using the Order API.

Important ! To have better insights of your payments you can leverage HiPay’s platform data management. To do so, we strongly recommend to send as much data as possible, as the basket and the customer information. Here you have all the parameters of the API.

Order API

User Experience

      1. Choice of iDEAL as payment method (merchant’s website)
      2. Choice of the issuing bank (merchant’s website)
      3. Redirection and Payment (issuing bank’s website)
      4. Confirmation page display  (merchant’s website)

Integration

With this integration you are in charge of displaying the payment method and the list of banks.

Once the customers selects the issuing bank and clicks on the payment button, you may use the Order API in order to redirect the customer to the issuing bank’s website. The way how you are going to communicate the issuing bank selected by the customer is by sending the BIC on the issuer_bank_id parameter.

Here you have the mandatory parameters of the ORDER API:

payment_product : iDEAL

orderid : unique order id. Ex: ORDER_1583157210

description : order short description. Ex. Summer Sales

amount : Total order amount. Ex: 9.99

currency : Order ISO 4217 three-character currency code. Ex: EUR

Specific to iDEAL

issuer_bank_id: This is the Business Identifier Code (BIC) of the customer’s issuer bank. Ex. SNSBNL2A

Endpoints

Stage: https://stage-secure-gateway.hipay-tpp.com/rest/v1/order

Production: https://secure-gateway.hipay-tpp.com/rest/v1/order

Make sure you have configured your HiPay account and the redirection urls before using the Order API.

Important ! To have better insights of your payments you can leverage HiPay’s platform data management. To do so, we strongly recommend to send as much data as possible, as the basket and the customer information. Here you have all the parameters of the API.