To start, place an iDEAL button as a payment option in your webshop. By clicking on this button, a Sale transaction request will be constructed and sent to our Gateway. Then your customers will be redirected to our hosted payment page, where the iDEAL payment process happens. Later, after being redirected to the login page, the customer can proceed with payment completion.

The table below represents the overview of mandatory and optional parameters to be included in the transaction request:

Field NameTypeDescription
checkoutoptionMandatoryDefault value is combinedpage
storenameMandatoryRepresents unique identification of your account in our Gateway system.
paymentMethodMandatoryMust be ideal
txntypeMandatoryAvailable values: 'sale’
chargetotalMandatoryThe total amount of the transaction, e. g. 12.34
currencyMandatoryRepresents the numeric ISO code of the transaction currency, e.g. 978 for EUR.
oidOptionalA unique ID for merchant to identify the transaction
If not provided, our system will generate automatically an order ID.
Only the following characters are allowed: A-Z, a-z, 0-9, "-"
customeridConditionalRepresents your customer identification number.
For iDeal transactions the customer ID will be displayed on client's bank account statement, if provided in the message.
responseFailURLMandatoryThe URL where you wish to direct customers after a declined or unsuccessful transaction.
The value needs to be identical to responseSuccessURL
responseSuccessURLMandatoryThe URL where you wish to direct customers after a successful transaction.
The value needs to be identical to responseFailURL
shippingOptionalShipping cost for Fast checkout feature.
flowTypeOptionalIndicator to trigger iDEAL Fast Checkout flow
Value : FastCheckout
subtotalOptionalSubtotal price - relevant for fast checkout feature, applicable when there is a shipping cost
chargetotal = shipping + subtotal

Want a quick overview?