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 note that currently only 7 customer banks support iDEAL QR within their own banking app (Knab, Rabobank, ING, ABN AMRO, ASN Bank, RegioBank and SNS Bank). 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)

  • If you would like to test iDEAL QR, please note that this will only work in a Live environment. The Testing environment is currently not available.


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

Submit your request to activate iDEAL QR through one of our account managers at [email protected]

Please do not forget to include your Account 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.


You're missing something out and would like us to fix it? Suggest an improvement to this page!


Other languages

Liever uitleg in het Nederlands? Neem contact op met uw accountmanager.

Vuoi ricevere informazioni in italiano? Contatta il tuo account manager.

Falls Sie eine deutschsprachige Erklärung bevorzugen, kontaktieren Sie bitte Ihren Kundenbetreuer

Prefieres tener la explicación en Español? Contacta con tu gerente de cuentas.

Vous préférez une explication en français? Contactez votre gestionnaire de compte.