Swiss QR bill on invoices

Mariia Korostashevych

Updated November 10, 2026 10:39

Purpose	Add a Swiss QR-bill to unpaid invoices and pro forma invoices so guests can pay by scanning a code with their banking app.
Best for	Property admins, managers, and front desk users at properties in Switzerland.
Use this when	Setting up the QR-bill, checking which documents include it, or finding out why a document has no QR page.
Requirements	A property in Switzerland with the Fiscal Documents service activated, and an IBAN saved in Payment details.
Expected result	Unpaid invoices and pro forma invoices include an extra last page with a Swiss QR-bill.

Introduction

The Swiss QR-bill is the standard payment slip used for bank transfers in Switzerland. When your property saves an IBAN, Cloudbeds adds a QR-bill to the end of unpaid invoices and pro forma invoices. The page contains a receipt and a payment part.

Guests scan the QR code with any Swiss banking app. The app fills in the bank account, amount, currency, and invoice reference automatically, so guests do not need to type them.

Availability: The Swiss QR-bill is available only for properties in Switzerland with the Fiscal Documents service activated. If the IBAN field is empty, documents are generated as before and no action is needed.

Set up the QR-bill
When the QR-bill appears
What the QR page shows
Turn off the QR-bill
Frequently asked questions

Set up the QR-bill

Enter your property's IBAN in the Invoices and Documents settings. The property has one IBAN, which invoices, pro forma invoices, and credit notes share.

From the Account Menu go to Settings
Select Finance
Select Invoices and Documents.
In the Payment details section, below Header logo, enter your property's bank account in the IBAN field.
Click Save.

The Save button stays disabled until you enter a value. After you save, the QR-bill is turned on for your property's eligible documents.

Check the IBAN before you save: The QR-bill prints the IBAN exactly as you save it, and guests send their payments to that account.

When the QR-bill appears

A document includes the QR-bill only when an IBAN is saved and the document meets the conditions in this table.

Document	QR-bill included
Invoice with a balance due above 0	Yes
Pro forma invoice with a balance due above 0	Yes
Credit note issued on an invoice that had a QR-bill	Yes, the same QR-bill
Fully paid invoice or pro forma invoice	No
Credit note issued on an invoice that had no QR-bill	No
Receipt	No
Sample preview in the Invoices and Documents settings	No

What the QR page shows

The QR page is added as the last page of the PDF. The example below shows the page on an unpaid invoice.

Pro forma invoices with an open balance get the same page.

Payer: The slip shows the billing profile selected on the invoice, either a person or a company, not the reservation guest. The payer is left blank if that billing profile has no complete address.
Legal company name and address: These are taken from your document settings. If they are empty, the hotel name and address are used instead.
Previews: Invoice and pro forma invoice previews include the QR page, with a "preview" watermark over the payment slip so a preview cannot be used to pay.

Turn off the QR-bill

The property controls the QR-bill with the IBAN field. To turn it off:

From the Account Menu go to Settings
Select Finance
Select Invoices and Documents.
Clear the IBAN field in Payment details.
Click Save.

Documents issued afterward are generated without the QR page. Documents that were already issued keep the PDF they were issued with.

Frequently asked questions

Expand a question for more information about availability and document behavior.

Why does my invoice not have a QR-bill page?

Check the following:

The property is in Switzerland and has the Fiscal Documents service activated.
An IBAN is saved in Payment details.
The invoice or pro forma invoice has a balance due above 0. Fully paid documents do not get a QR-bill.
The document is not a receipt, and it is not a credit note issued on an invoice that had no QR-bill.
The document was issued after the IBAN was saved. Documents that were already issued keep the PDF they were issued with.

Do credit notes include the QR-bill?

Yes, when the invoice the credit note is issued on had a QR-bill. The credit note carries the same QR-bill. Credit notes on invoices that had no QR-bill do not include one.

Can I use a different IBAN for each document type?

No. The property has one IBAN, which invoices, pro forma invoices, and credit notes share.

Can a guest pay using a preview?

No. Previews include the QR page, but a "preview" watermark is drawn over the payment slip so a preview cannot be used to pay.

What happens if I leave the IBAN field empty?

Nothing changes. Documents are generated as before, without a QR page.

Why is the payer blank on the QR-bill?

The slip shows the billing profile selected on the invoice. If that profile has no complete address, the payer is left blank. Complete the address on the billing profile to include it on documents you issue afterward.

With your IBAN saved, unpaid invoices and pro forma invoices now give guests a quick way to pay from their banking app.

Review these resources for related invoice, pro forma, credit note, and fiscal document topics: