Swiss QR Bill


Swiss QR Bill for WooCommerce introduces a new payment method for shops located in Switzerland or Liechtenstein, following the harmonization of Swiss payments based on the ISO 20022 standard in the implementation of the new Swiss QR Bill (see

The Swiss QR bill can be used from 30 June 2020, it replaces the old Swiss “ESR” payment slips.

As a shop owner you will need a new “QR-IBAN” for your bank account, and a reference number to use the plugin to send your clients valid Swiss QR bills.

Both will be provided by your bank upon request. You may consult this page for further information: The Swiss QR-bill.


This plugin requires a working installation of WordPress with everybody’s favorite shop plugin WooCommerce. It also requires you to enter a correct QR-IBAN and reference number. Furthermore, the PHP extension “intl” must be activated in your web hosting account. Please ask your host for yassistance if it is not activated.


The plugin only works for shop owners in Switzerland and Liechtenstein. If your shop country is not set to one of these two countries then the plugin cannot be activated.

Your clients must also reside in Switzerland and Liechtenstein to issue Swiss QR bill payments to you. The payment method will not be displayed in the checkout to users from any other countries.

The only currencies supported by Swiss QR bill payments are CHF and EUR. If the plugin is activated, the Swiss QR bill payment method will only be displayed in the checkout for orders with these two currencies.


  1. New “Swiss QR bill” payment method, which you can enable and disable like any other payment method. When activated, the payment method offers you several options (see below).
  2. The plugin automatically generates a valid Swiss QR bill PDF document for every order that uses the Swiss QR bill payment method. The QR code section is always displayed on the bottom of the first page of the invoice PDF. If there are many order items the plugin will automatically add a second and further pages to the invoice PDF as required.
  3. The PDF invoice document is automatically attached to the order confirmation email which is sent by WooCommerce to the user immediately upon order completion.
  4. As a shop owner you can review and download the PDF invoice document anytime in the WooCommerce order screen.
  5. The QR IBAN and reference number you enter will automatically be validated for correctness.
  6. You may optionally choose to restrict the Swiss QR bill payment method to registered users or to registered users who have completed at least one order previously.
  7. You may also restrict the Swiss QR bill payment method by product category.

We have various features in mind for the next versions. We are open to your suggestions.


The Swiss QR bill payment method offers the following custom settings:

Main settings

  • QR-IBAN (enter the QR-IBAN provided by your bank)
  • Reference number (enter the reference number provided by your bank)

Invoice data

You can customize the following data on your Swiss QR bills:

  • Shop Logo
  • Shop Name
  • Shop Street & Number
  • Shop Address Line 2
  • Shop Zip Code
  • Shop City
  • Shop telephone
  • Shop VAT number

When the plugin is activated for the first time, most of these fields will be filled in automatically from your WooCommerce settings. You are free to edit them as you prefer.

Optional Restrictions

  • Customer Account Restriction: If activated, the Swiss QR bill payment method will only be displayed to registered and logged in users.
  • Customer Order Restriction: If activated, the Swiss QR bill payment method will only be displayed to logged in users who have completed at least one previous order.
  • The product category restriction can be activated in the settings of each product category. If you disable the checkbox “Activate Swiss QR bill payments” for a category then the Swiss QR bill payment method will not be displayed if the cart contains at least one product from that category.


The plugin is available in English and completely translated into German and French. An Italian translation will follow.

The usage of this plugin is totally free, and the basic version will always remain free. Currently there is no limitation on the amount of Swiss QR bills to be generated and sent to your clients every month.



  • WordPress 4.6 or newer (latest version recommended)
  • WooCommerce 2.6 or newer (latest version recommended)
  • PHP 7.0 or newer (latest version recommended, the plugin supports PHP 7.4)
  • PHP extension “intl” activated in your webhosting account


We recommend installing and activating Swiss QR Bill for WooCommerce through the WordPress backend. Please install WooCommerce before installing our plugin.


After activating the plugin please navigate to WooCommerce – Settings – Payments and enable the “Swiss QR Bill for WooCommerce” payment method.


After enabling the payment method please click on “Manage” to review and edit all its settings. Please make sure to enter the correct QR-IBAN and reference number provided by your bank, otherwise the plugin will not work.


8 0813 January 0813 000000 2021
Congratulations to the HostBliss company for providing a free plugin that does its job perfectly. In Switzerland, the inpayment slip will be abolished in June 2021. It is perfectly translated into French for French speakers, German, Italian and English. The support is also very reactive. Thank you HostBliss
Read all 1 review

Contributors & Developers

“Swiss QR Bill” is open source software. The following people have contributed to this plugin.


“Swiss QR Bill” has been translated into 3 locales. Thank you to the translators for their contributions.

Translate “Swiss QR Bill” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • fix: Additional information adjusted


  • add: shop logo relative path.
  • fix: compatibility with sequential order number.
  • fix: dimension fixes for QR payment invoice part .
  • add: compatibility check with WC 4.9.1 .
  • remove: footer text.


  • fix: invoice logo resize cutoff.
  • add: french date format in invoice.
  • add: compatibility with sequential order number.
  • fix: product category gateway restriction.


  • fix: customer session check in backend.
  • fix: store location country update.


  • Text domain fixes.


  • Initial push.