On This Page
FILTER BY TAG

iDeal

iDEAL enables customers to pay online through their mobile banking app or online bank account and provides you with a payment guarantee. iDEAL supports these banks:
  • ABN AMRO
  • ASN Bank
  • bunq
  • ING
  • Knab
  • Rabobank
  • RegioBank
  • Revolut
  • SNS
  • Svenska Handelsbanken
  • Triodos Bank
  • Van Lanschot
When the total amount of the order is outside the range of accepted transaction amounts, the iDeal payment button is not displayed in
Unified Checkout
. These are the accepted transaction amounts:
  • Minimum transaction amount
    : EUR 0.01
  • Maximum transaction amount
    : Subject to transaction approval from the customer's account.

Billing Details for iDeal

The
captureMandate.billingType
 field value determines whether
Unified Checkout
 displays the full billing details form when iDeal requires partial billing details.
When the
captureMandate.billingType
 field is set to
FULL
 and iDeal requires partial billing details,
Unified Checkout
 displays the full billing details form.
  • If the merchant includes all required fields in the capture context request, and the billing country is compatible with the payment type, the consumer currency, or both, the consumer sees a billing summary confirmation screen.
  • If the merchant does not include all required fields in the capture context request, the consumer sees the full billing details form.
When the
captureMandate.billingType
 field is set to
PARTIAL
 and iDeal requires partial billing details,
Unified Checkout
 displays the full billing details form.
  • If the merchant includes all required fields in the capture context request, and the billing country is compatible with the payment type, the consumer currency, or both, the consumer sees a billing summary confirmation screen.
  • If the merchant does not include all required fields in the capture context request, the consumer sees the full billing details form.

Opt in to iDeal on
Unified Checkout

You can enable iDeal from the
Unified Checkout
 merchant experience section in the
Business Center
. For information about how to enable iDeal using the
Business Center
, see Configure Payment Options.
You can also enable iDeal using the
Unified Checkout
v1/sessions
 API. Follow these steps to opt in to the iDeal payment method using the API:
  1. Add iDeal to your integration by adding
    IDEAL
     to the
    allowedPaymentTypes
     field object within the capture context request.
  2. Set the
    completeMandate.type
     field value to
    CAPTURE
     or
    PREFER_AUTH
    .
    You can capture the funds immediately if you include the
    completeMandate.type
     field in the capture context request and set the value to
    CAPTURE
    .
    If you accept more than one payment type and must perform an authorization where funds are collected at a later time, set the
    completeMandate.type
     field to
    PREFER_AUTH
    . The funds are captured immediately for the online bank transfer.
  3. Include these required fields for online bank transfers in the capture context request:
    • data.orderInformation.billTo.country
    • data.orderInformation.billTo.firstName
    • data.orderInformation.billTo.lastName
  4. Include this optional field for online bank transfers in the capture context request:
    • data.orderInformation.billTo.address1
    • data.orderInformation.billTo.email
IMPORTANT
When you do not include the billing and shipping information in the capture context request, a pop-up will appear for the merchant to provide this information during checkout.
RELATED TO THIS PAGE