iDEAL 2.0
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 Name | Type | Description |
---|---|---|
checkoutoption | Mandatory | Default value is combinedpage |
storename | Mandatory | Represents unique identification of your account in our Gateway system. |
paymentMethod | Mandatory | Must be ideal |
txntype | Mandatory | Available values: 'sale’ |
chargetotal | Mandatory | The total amount of the transaction, e. g. 12.34 |
currency | Mandatory | Represents the numeric ISO code of the transaction currency, e.g. 978 for EUR. |
oid | Optional | A 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, "-" |
customerid | Conditional | Represents your customer identification number. For iDeal transactions the customer ID will be displayed on client's bank account statement, if provided in the message. |
responseFailURL | Mandatory | The URL where you wish to direct customers after a declined or unsuccessful transaction. The value needs to be identical to responseSuccessURL |
responseSuccessURL | Mandatory | The URL where you wish to direct customers after a successful transaction. The value needs to be identical to responseFailURL |
shipping | Optional | Shipping cost for Fast checkout feature. |
flowType | Optional | Indicator to trigger iDEAL Fast Checkout flow Value : FastCheckout |
subtotal | Optional | Subtotal price - relevant for fast checkout feature, applicable when there is a shipping cost chargetotal = shipping + subtotal |
Updated 10 days ago