QR codes

In the context of payments, QR codes enable customers to transfer the payment flow from their desktop or laptop computer to their mobile device. This is the so-called desktop-to-mobile flow.

QR codes also allow your customers to pay without requiring manual input leading to lower error rates.

In most cases, this works by scanning a QR code during the payment process using a dedicated app on a phone. For example, iDEAL payments support a QR code that can be scanned using the iDEAL app or directly from within the banking app. The customer then completes the transaction from his or her mobile device.

How do QR codes work?

  1. You generate a QR code for a payment method using the Mollie API.
  2. You show the QR code to the customer during the checkout.
  3. The customer opens the app on a mobile device and scans the QR code.
  4. The customer finishes the payment in the app on the mobile device.
  5. Mollie informs you of the payment status change using the webhook.
  6. The customer is redirected back to the webshop on their computer.


Only iDeal QR works in testmode.

Supported payment methods

iDEAL iDEAL QR codes can be scanned using the app of you bank, the dedicated iDEAL app, or the iPhone camera app directly. After scanning the code, the customer can easily pay via their banking app.
Bancontact Bancontact QR codes can be scanned using the Bancontact app, Belgian mobile banking apps, or the iPhone camera app directly. The QR code is only available for payments under €500.00.
Bank transfer Many mobile banking apps support scanning EPC QR codes for SEPA credit transfers. Note that there is no real-time feedback for this payment method.

Implementation options

Two options for implementation are available:

Mollie Checkout Mollie Checkout contains QR codes at all the right places and handles the QR code logic for your application. It supports real-time feedback to the customer after they finish the payment.
Custom implementation Should you want to, you can implement QR codes in your own application using the Mollie API. Some special considerations need to be taken into account, they are listed below.

Custom implementation

The QR code flow is largely similar to normal payment flow.


Retrieving QR codes

The QR code can be retrieved by adding the details.qrCode include to the payment creation API call, and a method parameter to the body of your request as detailed in the Create payment reference.

POST https://api.mollie.com/v2/payments?include=details.qrCode

The API will return a qrCode object in the details object. The QR code can contain either a data:image/ URI (i.e. an image encoded in an URI) or an https:// URL pointing to the QR code image, depending on the payment method. You should support both.

QR codes are only included in the API as long as the payment has the open status. For iDEAL, the QR code is only available if no issuer has been selected yet.

Redirecting the customer

After the payment, we will call the webhook to inform your application of the payment status changes. Since the customer has completed the payment on the mobile device, it is your task to ensure that a payment success page is automatically shown to the customer on the desktop or laptop computer.

Preferably, you should use a real time channel like websockets to ensure an optimal checkout experience.

Note that after the payment, the customer will also be redirected to the redirectUrl on the mobile device for some payment methods (such as iDEAL). For Bancontact, a special thank you page is shown on the mobile device.

For iDEAL you should make sure that the customer receives instructions to continue the shopping process on the device on which he or she initiated the payment, and an instruction to close the window on the mobile device.