QR code payments

QR code payments allow users to generate a code that customers can scan with their mobile banking app to initiate a bank transfer or pay instantly.

Configuration

Activate and set up QR code payments

Go to Accounting ‣ Configuration ‣ Settings, and

  1. Activate or upgrade your country’s fiscal localization package under the Fiscal Localization section to access all country-specific accounting features.

  2. Activate QR codes under the Customer Payments section.

Then, as the QR code type differs depending on your country, follow the corresponding documentation page from the following table to set them up.

QR code types

Module name

Technical name

Description

Pix

Brazilian - Accounting

l10n_br

The base module to manage the accounting chart and localization for Brazil.

FPS

Hong Kong - Accounting

l10n_hk

The base module to manage the accounting chart and localization for Hong Kong.

QRIS

Indonesian - Accounting

l10n_id

The base module to manage the accounting chart and localization for Indonesia.

PayNow

Singapore - Accounting

l10n_sg

The base module to manage the accounting chart and localization for Singapore.

QR-bill

Switzerland - Accounting

l10n_ch

The base module to manage the accounting chart and localization for Switzerland.

PromptPay

Thailand - Accounting

l10n_th

The base module to manage the accounting chart and localization for Thailand.

VietQR

Vietnam - Accounting

l10n_vn

The base module to manage the accounting chart and localization for Vietnam.

EPC

Account SEPA QR Code

account_qr_code_sepa

This module adds support for SEPA Credit Transfer QR-code generation.

Create the payment method

  1. Open the Point of Sale application.

  2. Go to Configuration ‣ Payment Methods and create a payment method.

  3. Set a bank-type journal.

  4. Select Bank App (QR Code) under the Integration section.

  5. Select the QR Code Format from the dropdown menu.

    • Select SEPA Credit Transfer QR if you are part of the Single Euro Payments Area (SEPA).

    • Select EMV Merchant-Presented QR-code for other QR code types.

screenshot: pos-qr-payment-method-form
menu
Point of Sale ‣ Configuration ‣ Payment Methods ‣ New
shows
A payment method form with a bank journal selected, "Integration" set to "Bank App (QR Code)" and a "QR Code Format" chosen.
highlight
The "Integration" and "QR Code Format" fields (red frame).
data
Payment method "Bank App", bank journal "Bank", format "SEPA Credit Transfer QR".
module
point_of_sale, account_qr_code_sepa
notes
English UI, light theme, 1440px width; scale down to about 85 % of the page width.

Important

At least one bank account must be defined in the journal to allow QR code payments to be registered with bank apps.

Once the payment method is created, go to the POS’ settings and add the payment method to your POS under the Payment section.

screenshot: pos-qr-payment-enable
menu
Point of Sale ‣ Configuration ‣ Settings
shows
The "Payment" section of the POS settings with the QR code payment method added to the "Payment Methods" field.
highlight
The "Payment Methods" field (red frame).
module
point_of_sale
notes
English UI, light theme, 1440px width; scale down to about 85 % of the page width.

Register payments using QR codes

When processing a payment, select the payment method for QR code payments. A QR code is generated and displayed on the screen for the customer to scan and pay with their mobile banking app.

screenshot: pos-qr-payment-screen
menu
(POS interface) ‣ Payment screen
shows
The POS payment screen with the QR code payment method selected and the generated QR code displayed for the customer, with the "Confirm Payment" button below.
module
point_of_sale
notes
English UI, light theme; scale down to about 75 % of the page width; use a throw-away bank account.

Hit Confirm Payment to validate the transaction.

Important

Odoo does not check the bank payment. It is recommended that users verify payments for validity before confirming them on the POS register.