What it is

iDEAL QR is an additional service offered by the Dutch payment method iDEAL. As the name suggests, iDeal QR allows customers to pay directly with their smartphone, from both screen and print. With iDEAL QR you can take offline payments to the online world. Most Dutch banks have their own QR codes on their payment screens, but this is not the same as iDEAL QR.

How it works

MultiSafepay supports seamless integration for iDEAL QR. As a merchant, you must either:

  • Be able to able to retrieve and process the PNG image for the QR code on your side, in order to display it to the customer


  • Redirect the customer to our payment page similarly with other payment methods.

With iDEAL QR you can also produce a generic link that can be used multiple times. The QR code can be printed on leaflets. You can also enable an option to allow the customer change the amount.

Please not that currently only 4 customer banks support iDEAL QR within their own banking app (Rabobank, Knab, ING and ABN AMRO). All other customers must use the dedicated iDEAL app.

Transaction flow

The transaction flow shows the different ways a transaction can be processed. This differs per payment method.

  • Order status
    The order status indicates the status of the order, such as completed, pending or rejected. The order status is independent of the incoming or outgoing payment of the transaction.

  • Transaction status
    The transaction status indicates the payment status of the transaction, such as completed, pending or rejected. Once the transaction status is completed, the amount of the transaction is added to your MultiSafepay balance.

Order Status Transaction Status Description
Initialized Initialized A payment link has been generated, but no payment has been received yet.
Completed Completed A successful iDEAL QR transaction has been received and the funds will be added to your MultiSafepay Control balance.
Expired Expired An unfinished transaction will automatically expire after a predefined period.
Void Cancelled Transaction has been cancelled.

Refund flow

Order Status Transaction Status Description
Initialized Initialized A refund has been requested.
Completed Completed Refund has been successfully processed.

The full API reference for iDEAL QR can be found here.

Product rules

Some rules may apply to certain payment methods. For iDEAL QR, the following rules apply:

  • Refunding more than the stated amount of the original transaction is possible with iDEAL QR. More information is available on our refund more than original amount page

  • Successful iDEAL transactions have no expiring date regarding refunding, as long as the receiving bank is able to process the refund

  • Payments done through iDEAL QR are processed in Euros (EUR).


Important: iDEAL QR must be requested manually in order to enable it in your MultiSafepay Control.

Submit your request to activate iDEAL QR through our Integration Team at [email protected]

Please do not forget to include your Merchant ID along with your request.

Request refund

You can refund iDEAL QR transactions either in MultiSafepay Control or through our API.

Please follow these steps to refund a iDEAL QR transaction:

  1. Login into your MultiSafepay Control
  2. Select transaction -> transaction overview
  3. Find the transaction through search
  4. Open transaction
  5. Select refund
  6. Fill in the amount that you want to refund to the customer
  7. Confirm the refund.

Please note that by default, MultiSafepay does not allow for you to refund more than the stated amount of the original transaction. Please refer to the product rules for more information.

  • The transaction status is now initialized. As long as the transaction status is marked as initialized, the refund can be cancelled. When the transaction status is marked as completed, the refund is processed correctly. The customer will receive the refund to the bank account number in which the transaction was originally paid to, within the next business day

A refund will only be processed if your balance on your MultiSafepay Control is sufficient.

In the event of a failed iDEAL QR refund, please contact our support team at [email protected] to assist you.