[Skip to main content](#vessel-content)

[View on the marketplace →](/marketplace/display/product/139-qr-bill) ☰ Documentation

#  Swiss QR Bill payment plugin

Details    Written by: Administrator    Category: [Payment plugins](/support/documentation/hikashop/payment-plugins)     Published: 10 November 2026     Hits: 6

## Installation

- 1) You need a Swiss bank account with a QR-IBAN (or a standard IBAN if you do not use the QR reference). If your bank gave you a BESR-ID and you are not with PostFinance, keep it at hand.
- 2) Install this plugin on your Joomla or WordPress website: in Joomla with the extension installer, in WordPress with the "Install Plugin" button of HikaShop's payment plugins page. The package weighs more than 30 MB because of the libraries that draw the QR bill: if your host limits the size of uploads, extract the package on your computer and install it from a folder instead.
- 3) In HikaShop, go to System > Payment methods, click "New" and choose Swiss QR Bill.
- 4) Fill in the settings below, set "Published" to Yes and save.
- 5) The plugin needs the post code, city, country and last name of the customer address. On the payment method page, it checks your address fields and warns you when one is not published, or is published but not required. Publish and require them in the HikaShop address fields (the country field may stay unpublished for a shop that only sells in one country: the country of the payment method is then used).
- At the end of the checkout the customer gets a link to download the QR bill (PDF), and the PDF can be attached to the order emails. You can create it again at any time with the "QR-Bill" button of the order page in the HikaShop backend.
- The plugin needs PHP 8.4 or later with the intl, mbstring and gd extensions.

## Configuration

![The Swiss QR Bill settings in the HikaShop payment method](/images/doc/plugins/qrbill/plg_hikashoppayment_qrbill_settings.png)

- **Your company name**, **Your company street name**, **Your company house number**, **Your company post code**, **Your company city**: your address, printed as the creditor on the payment slip. Values too long for the QR bill standard are shortened.
- **Your company country (2 letters code)**: the country code of your address, CH by default. It is also used as the country of the customer when the country address field is not published.
- **QR IBAN**: Yes when the account below is a QR-IBAN, the QR bill then carries a QR reference. No when you give a standard IBAN, the QR bill then has no reference.
- **Your QR-IBAN**: your QR-IBAN, or your IBAN when QR IBAN is set to No.
- **Your BESR-ID**: the BESR-ID given by your bank. Leave it empty if you are with PostFinance.
- **Additional information**: a short text printed on the slip, "Invoice {invoice\_number}" by default. {invoice\_number} and {invoice\_date} are replaced by the number and the date of the invoice.
- **House number field column name (if any)**: if your address form has a separate house number field, type its column name here so the slip uses the street and the number separately. Empty, the number is read out of the street field.
- **Attach to customer email**: "No" never attaches the QR bill, "Order creation and status change emails" attaches it to both, "Order creation email only" (the default) attaches it to the email sent when the order is created.
- **Order status notification**: Yes sends the customer the usual order status email when the order is moved to the status below, No does not.
- **Include invoice header**: Yes prints a small invoice (creditor, customer, lines, totals) above the payment slip on the same page, so one document is both the invoice and the slip. Choose No if you already send an invoice from elsewhere and want the PDF to be the slip alone.
- **Return url**: an address the customer is sent to after the order is placed. Empty keeps the usual HikaShop page.
- **Order status**: the status given to the order when it is placed ("Created" by default).
- The other settings of the page (name, description, images, price, zone, currency, restrictions) are the same as for every HikaShop payment method.

## Troubleshooting

- An order email arrives without the QR bill: the reason is written to the HikaShop payment log (System > Configuration, Files, "See the report" next to "Payment log file"), most often an incomplete billing address because a required address field was left empty. Make the address fields required.
- "The address field ... is not published" or "... is published but not required", shown on the payment method page: publish and require the field in the HikaShop address fields, otherwise the order emails will not carry the QR bill.
- The informational notice about the country field: the country field is not published, so the country of the payment method is used for the customer.
- The QR bill cannot be created from the "QR-Bill" button: the problems found with the IBAN, the references or the addresses are shown on screen. Check that the IBAN matches the QR IBAN setting.