Standard payment transaction

In a standard payment transaction, at least the email and country are needed from the shopper for creating an order.

The payment flow can be found here.

When starting the payment via the api, only method needs to be provided in the request as shown below:

{
	"method": "IDEAL"
}

Note :

Standard payment transaction can be done via the menu and rest api call.
The email address is mandatory for Standard payment transaction.
The billing address is optional and can be provided with the billing_address_key.

Fast checkout

Fast Checkout also known as Snel Bestellen is an iDEAL 2.0 feature where a merchant can request the details of the
shopper when they pay using iDEAL.

This functionality allows for a faster (guest) checkout since the shopper does not have to enter their details in the checkout. Instead an iDEAL Snel Bestellen button can be used as part of the checkout and the requested shopper details can be retrieved after the completion of the Payment.

Fast checkout can't be done via the menu. It can only be done by rest api call.

Payment Flow

The following diagram shows the payment flow for fast checkout :

Ideal fast checkout via Api

Creating an Order

Create a new order without email or country to use IDeal Fast Checkout.

Note :

The email address and billing address are optional.
If email is not provided, then only IDEAL payment method is available.

Creating an Order items

Create Order items for newly created order.

Note : at least one item with type as shipping fee should be there as shown below.

{
   "number"        : 1,
   "code"          : "SHIP-COST",
   "name"          : "Shipping items cost",
   "type"          : "SHIPPING_FEE",
   "quantity"      : 1,
   "currency"      : "EUR",
   "unit_amount"   : 200,
   "amount"        : 200,
   "vat_amount"    : 0,
   "vat_rate"      : 0
}

Start Payment

The shopper details to be requested is provided as part of the start payment request as below :

{
    "method": "IDEAL",
    "request_shopper_details" : ["NAME", "PHONE", "EMAIL", "SHIPPING_ADDRESS", "BILLING_ADDRESS"]
}

Note :

If 'request_shopper_details' is provided then the ideal payment is considered as fast checkout. It should contain at least one value.
For GDPR there are requirements to only request data that you actually need.

Status request

Make a status request call to get all the details of the order, including the generated billing address key.

Note : The billing address key is same as the shopper key.

Get Shopper Details

The merchant should make get shopper address api call to get the requested shopper details using the billing address key returned in the status request.

Branding Guidelines

There are some guidelines when displaying Fast Checkout (a.k.a. Snel Bestellen) in your checkout. At the bottom of this page are 6 variations of the button available as SVGs.

Label :
- Use “Snel bestellen” (default) or “Checkout”, matching your site/app language.
- Format: Sentence case (e.g., "Snel bestellen").
- Do not modify, shorten, translate, or fully capitalize the text.
Font
- Montserrat (medium weight, 0% letter spacing).
- Size = 0.65 × logo height (h), within 13pt (min) – 26pt (max).
- Do not use other fonts, weights, or exceed size limits.
Logo
- Use the official iDEAL Snel bestellen logo (min. 20dp height, never below 16dp).
- Must always appear with the text label.
- Do not modify colors, resize improperly, or use the logo alone.
Style
- Available in magenta or white—ensure contrast with background.
- Default corner radius: 5, but can match other payment buttons.
- Do not alter button styling.
Button States
- Supports enabled, hover/pressed, and focused states.
- The focus state can match your site/app’s design.
Sizing
- Button must be equal to or larger than other payment buttons.
- Resize proportionally per guidelines to maintain correct font and layout.
- Do not make it smaller than the minimum required size.
Clear Space & Placement
- Maintain at least 8px of spacing around the button.
- Best practice: Display as the primary payment option.