With a QR-bill it isn't the layout that matters first, it's the technical logic. When account, address, payment data and reference fit together, the payment is processed automatically in e-banking. When they don't, you get a follow-up email instead.
| Field | What goes in it | Why it matters |
|---|
| Account | QR-IBAN or normal IBAN | Determines which reference type is allowed |
| Address | Name, street, house number, postcode, town, country | Must be structured (mandatory since 21/11/2025) |
| Payment data | Amount, currency (CHF or EUR only) | Secures correct payment allocation |
| Reference | QR-reference (QRR), SCOR or none (NON) | Enables automatic reconciliation |
Structured addresses are mandatory. Since 21 November 2025 (Implementation Guidelines v2.3) only structured addresses are allowed in the Swiss QR Code: street, house number, postcode, town and country code each in their own field, not "Bahnhofstrasse 10, 8001 Zürich" on one line. Both tools above already capture the address separately; old Word templates usually fail on exactly this point.
The QR code must be exactly 46 × 46 mm, black on white, with the Swiss cross (7 × 7 mm) in the middle. If the code is too small, distorted or embedded as a blurry image, the banking app can't read it.
The reference formats. The QR-reference (QRR) is 26 digits plus a check digit under modulo-10 recursive and works only with a QR-IBAN (recognisable by the bank clearing number 30000 to 31999). SCOR uses the ISO-11649 format and works with your normal IBAN. Without a reference (NON) you write a message like "Invoice 2026-014" in the field. The most common trap is the wrong combination: a normal IBAN plus a QR-reference does not produce a valid document. More under QR-IBAN example.
CHF and EUR only. If you bill in USD or GBP, send a normal invoice without a payment slip and give your IBAN and BIC in plain text.
A fictional graphic designer from Bern invoices a bakery in Thun CHF 1'232.34. She has no QR-IBAN and therefore uses the "IBAN without reference" variant, like most freelancers. This is how invoice section and payment part are built:
| Section | Field | Example |
|---|
| Invoice | Issuer | Lea Brunner Grafikdesign, Kramgasse 12, 3011 Bern, UID CHE-123.456.789 |
| Invoice | Recipient | Bäckerei Frei GmbH, Bahnhofstrasse 8, 3600 Thun |
| Invoice | Invoice number / date | 2026-041 / 8 September 2026, payable by 8 October 2026 |
| Invoice | Service | Design of flyer and menu, 12 h at CHF 95.00 |
| Invoice | Amount | Subtotal CHF 1'140.00, VAT 8.1% CHF 92.34, total CHF 1'232.34 |
| Payment part | Account / payable to | CH93 0076 2011 6238 5295 7, Lea Brunner Grafikdesign, Kramgasse 12, 3011 Bern |
| Payment part | Payable by | Bäckerei Frei GmbH, Bahnhofstrasse 8, 3600 Thun |
| Payment part | Currency / amount | CHF 1'232.34 |
| Payment part | Reference | none (NON) |
| Payment part | Additional information | Invoice 2026-041 |
How to read the payment part: it occupies the bottom 105 mm of the A4 sheet. On the left the receipt (62 mm wide) with account, recipient, amount and the "acceptance point" field, on the right the payment part (148 mm wide) with the Swiss QR Code in the middle and the same details in plain text next to it. When scanned, the banking app must show exactly these values: recipient, IBAN, CHF 1'232.34 and the message "Invoice 2026-041".
With a QR-IBAN the reference field would hold a 27-digit QR-reference (such as 21 00000 00003 13947 14300 09017) instead of the message, and the bookkeeping could match the incoming payment automatically. That pays off from a few dozen invoices per month, not from three.
In short: the QR payment part is the only payment slip still allowed, but a payment slip itself is not mandatory. Since 1 October 2022 no Swiss bank or post office processes orange or red payment slips. If you want to give your client a payment slip, it has to be the QR payment part; there is no other permitted option.
You are not obliged to include a payment slip at all, though. An invoice with IBAN, name and amount in plain text is legally complete; your client then types the payment in manually. The QR-code simply makes paying radically easier, and the rule depends neither on turnover nor on legal form.
Not to be confused with eBill. eBill delivers the invoice straight into the recipient's e-banking, without PDF and without scanning, and requires registration with the eBill network. The QR-bill works with any email and on paper.
The switch-over in three sentences: the QR-bill was introduced on 30 June 2020, after which both systems ran in parallel for a good two years. On 30 September 2022 the transition period for ESR and ES ended. Since 21 November 2025 (version 2.3) structured addresses are mandatory as well; SIX updates the standard each November, so check once a year that your software produces the current version. (As of September 2026)
A readable QR-code is not yet a valid QR-bill: the scanner recognises the code even when IBAN and reference type don't match. Before sending, a two-stage check is worth it.
- Scan test with your own banking app. Open the PDF, choose "Scan QR code", point the camera at the code. Check recipient, IBAN, amount, currency and reference. If the app shows anything different from the printed payment part, the invoice must not go out.
- Technical validation in the SIX portal. For templates you reuse, or after switching software: in the SIX validation portal you upload the image of the QR-code or the decoded text and get an error log covering structure, version and mandatory fields.
The most common errors it catches: a QR-reference on a normal IBAN, an address on a single free-text line, an amount in the code that differs from the printed amount, a code exported too small. The validator only checks the technology; VAT rate and service description remain your job.