Payment Method Properties

Transaction Flow

1. The consumer selects iDEAL as their preferred payment method.
2. The consumer is redirected to a payment page where they are presented with an option to select their preferred bank or to scan a QR code.
3. If:
   1. The consumer chooses a bank from the list, they are redirected to their online bank where they are requested to confirm the payment.
   2. The consumer scans their QR code, they must confirm the payment in the banking app.
4. The merchant receives the payment confirmation.
5. The merchant can ship the order/deliver the goods to the consumer.

iDEAL Integration

Specific input parameters for the TRANSACTION call

For standard input parameters, see Input parameters for the TRANSACTION call.

Specific output parameters for the TRANSACTION call

For standard output parameters, see Output parameters for the TRANSACTION call.

TRANSACTION call input

tag=ideal
&txtype=TRANSACTION
&countrycode=NL
&currency=EUR
&amount=1055
&merchanttxid=cNKeGUHheQzp
&login=johndoetest
&password=wXBrpVporFVjGO4R
&contractid=JOHNDOETESTCONTRACT
&channel=testchannel
&merchantredirecturl=https%3A%2F%2Fmerchant.com%2Fwork%2Fppro2%2Flanding.php
&notificationurl=https%3A%2F%2Fmerchant.com%2Fwork%2Fppro2%2Fnotification.php
&specin.dynamicdescriptor=DynDescriptor
&accountholdername=John%20Doe
&returnmode=urlencodeext

TRANSACTION call output

REQUESTSTATUS=SUCCEEDED
&STATUS=SUCCEEDED
&TXID=599028382
&ERRMSG=
&CHANNEL=testchannel
&TAG=ideal
&PAYMENTGUARANTEE=NONE
&REDIRECTSECRET=P7QEgfywdtrB7pgwdVEVzu4gqrHOXA1m
&SPECOUT.PAYMENTPURPOSE=3IOLJ1S
&SPECOUT.SRCACCOUNTHOLDER=John Doe
&SPECOUT.SRCBIC=ABNANL2A
&SPECOUT.SRCCOUNTRY=NL
&SPECOUT.SRCIBAN=NL18ABNA0484869868

Additional Information

Transaction state changes

Transactions may change from any state at any time. This change occurs especially from a FAILED to a SUCCEEDED state. SUCCEEDED is considered a stable state (see also Important note about transaction states).

Integration options

There are two integration options:

1. Using a PPRO-hosted payment page
2. By-passing the HPP and redirecting straight to the iDEAL supported banks

Using a PPRO-hosted payment page

If specin.bic is not provided, the consumer is redirected to a bank selection page.

Within the PPRO-hosted payment page, the consumer is either prompted to select a bank or scan the QR code.

The payment page adjusts to different screen sizes based on the device of the consumer:

• Small mobile devices (<350px width): The bank list is rendered in a single column; no QR code; The transaction summary is above the bank list
• Large mobile devices (350px - 1280px width): The bank list is rendered in two columns; no QR code; The transaction summary is above the bank list
• Large screens (>1280px width): The bank list is rendered in 2 columns; the QR code is shown to the right of the bank list; the transaction summary is rendered above the QR code

By-passing the HPP and redirecting straight to the iDEAL supported banks

The second option requires you to send PPRO the BIC of each supported bank:

Branding Guidelines

For information regarding branding, see the iDEAL branding guidelines.

FAQ

Why does the iDEAL bank-hosted checkout page break when using iframes?

iDEAL does not allow using iframes for rendering its flows. Many of the iDEAL banks will fail to render checkout elements or display errors during the process. The scheme’s rules strictly forbid the use of iframes. PPRO recommends not using iframes for any LPMs as iframes can be misleading or cause unexpected behavior with an LPM.

Why is an "invalid URL" error displayed at the bank’s checkout when using a mobile browser on iOS?

The error is being displayed because the consumer may have erroneously tapped the “open in [bankname] app” link/button during the bank’s iDEAL checkout process. The link/button is ultimately an app url (ex: INGNLBANK://) designed to invoke the bank’s own app to complete the payment. iOS can't handle these URLs if an app is not installed as a handler of the URL, therefore an error is emitted that the URL is not known.