Built for the Swiss market

Payments in Switzerland

Swiss QR Bill in a Mobile App: How QR Payments Work and When to Use Them

Every Swiss household knows the QR bill: it is how invoices have been paid since the old payment slips were retired in 2022. For apps that sell events, memberships or services in Switzerland, it can be a simpler alternative to a card checkout. This guide explains how a QR bill flow works in an app, what it needs on the backend, and when it is the right choice.

Thomas Siudut
Thomas SiudutCo-Founder and CEO, Apps Value
September 26, 20268 min read
SwitzerlandPaymentsQR bill
Short answer

To use the Swiss QR bill in a mobile app, the backend generates a bill with the amount, the creditor account and a unique reference, sends it as a PDF by email or shows it in the app, and the user pays it by scanning the QR code in their banking app. The payment is then matched to the purchase by its reference, automatically from bank statement files or manually. It suits events booked ahead, memberships and invoices, where instant confirmation is not required.

Key takeaways for Swiss founders and product owners

  • Familiar by default. Swiss users pay QR bills every month, so there is nothing new to learn.
  • No card checkout to build. The app never handles card data; the payment happens in the user's own banking app.
  • Not instant. Payment arrives with the bank transfer, so the flow must handle a waiting state.
  • The reference does the work. A structured reference on every bill is what makes automatic matching possible.

What the Swiss QR bill is

The QR bill is the standard Swiss payment slip, introduced in 2020 and the only format since the orange and red slips were withdrawn in autumn 2022. The payment part carries the Swiss QR code, marked with the Swiss cross, which contains everything the bank needs: the creditor account, the amount in CHF or EUR, and a reference for the payment.

The format follows the Swiss implementation guidelines published by SIX, so any compliant bill can be paid in any Swiss banking app, by scanning the code or by uploading the PDF in e-banking.

Zurich at night, where apps use the Swiss QR bill for payments

How a QR bill payment flows through an app

From the user's side it takes a few taps. Behind them sit five steps that the product and the backend have to design together.

In the app

The user commits to a purchase

A member signs up for an event, renews a membership or confirms an order. The app records it as waiting for payment.

Backend

A QR bill is generated

The backend creates a bill with the amount, the creditor account and a unique reference for this purchase, and renders it as a PDF with the Swiss QR code.

Email or app

The bill reaches the user

The PDF goes out by email or is shown in the app. No card details and no payment provider SDK touch the app.

Banking app

The user pays

The member scans the QR code in their banking app, which fills in the account, amount and reference, and confirms the payment.

Reconciliation

The payment is matched

When the money arrives, it is matched to the purchase by its reference, either automatically from the bank statement files or manually by the team, and the app marks it as paid.

The QR bill moves the payment out of the app and into the user's banking app. The product work is in what happens before and after.

What the backend needs

  • The right account and reference type. A QR reference requires a special QR IBAN from the bank; a standard IBAN works with an international creditor reference or with no reference. The choice decides how easily payments can be matched.
  • Bill generation. Creating the QR code and the PDF to the Swiss guidelines. Tested open source libraries exist for most backend languages, so this rarely needs to be built from scratch.
  • A waiting state in the app. Every purchase needs a clear status between signed up and paid, and rules for what happens if the bill is not paid in time.
  • Reconciliation. Swiss banks provide statement files in the ISO 20022 format that list incoming payments with their references. Reading them lets the system mark purchases as paid automatically; a small first version can start with the team confirming payments by hand.

This is general guidance, not payments or legal advice. The bank that holds the account is the best source for the exact setup of QR IBANs and statement files.

QR bill, TWINT or card

The QR bill is not a replacement for every payment method. It fits some purchases very well and others poorly.

Swiss QR billTWINTCard
ConfirmationWhen the transfer arrives, usually not instantInstantInstant
Fees for the businessUsually only standard bank feesTransaction feesCard processing fees
What users know it fromEvery invoice they payPaying in shops and to friendsOnline shopping everywhere
Best forEvents booked ahead, memberships, invoicesQuick purchases in person or in the appInternational users and instant access

Many Swiss products combine them: a QR bill for events and memberships booked ahead, and TWINT or cards where the user needs access immediately. Real world services such as events can usually be sold outside Apple and Google in app purchase; our guide to in app purchase fees explains where the line runs.

A QR bill flow in a real product

For Souly, a social networking app for a Zurich community, we built event payments around the QR bill. Members sign up for an event in the app, a QR bill arrives by email, and they pay it in the banking app they already use for invoices.

The Souly case study shows the product, and our guide to building an app for the Swiss market covers languages, formats and data protection around it.

About the source

Who is answering this?

CompanyApps Value, mobile app development agency
LocationKraków, Poland
Markets servedUnited States, Western Europe, Nordics
Experience6 years, 19+ projects delivered, 13+ positive client reviews
TechnologiesFlutter, React Native, NestJS, Supabase, PostgreSQL, AWS, Google Cloud
Engagement modelsFixed price contracts and dedicated development teams

FAQ

Can a mobile app accept payments with the Swiss QR bill?

Yes. The backend generates a QR bill with the amount, the creditor account and a reference, sends it to the user by email or in the app, and the user pays it in their banking app. The payment is then matched to the purchase by its reference.

Is a Swiss QR bill payment instant?

No. The money arrives with the bank transfer, so the app needs a waiting state between purchase and confirmed payment. For instant access, TWINT or card payments fit better.

Do I need a QR IBAN?

Only if you want to use the QR reference. A standard IBAN works with an international creditor reference or without a reference. Your bank can advise which setup fits your reconciliation.

How are QR bill payments matched to orders?

By the reference on each bill. Swiss banks provide statement files in the ISO 20022 format listing incoming payments with their references, which a system can read to mark orders as paid. A small first version can confirm payments manually.

Should a Swiss app use QR bill, TWINT or cards?

It depends on what is sold. QR bills suit events booked ahead, memberships and invoices; TWINT and cards suit purchases that need instant confirmation. Many products combine them. Our page on app development for Swiss companies covers how we work with clients in Switzerland.

Does Apple take a commission on QR bill payments in an app?

Real world services, such as events held in person, can usually be sold outside Apple and Google in app purchase. Digital content used inside the app follows different store rules.

Thomas Siudut, Co-Founder and CEO of Apps Value
Written by Thomas Siudut Co-Founder and CEO, Apps Value

Thomas sets the company's long term strategy and direction, identifies market opportunities, and owns business development and client acquisition. He builds strategic partnerships that last beyond a single project. He works with clients from the first strategy conversation, so their business goals, not just their feature list, drive every decision.

Building an app for Swiss Market?

We work on Central European Time, the same as Zurich, and have built Swiss QR bill payments into a live product. Tell us about yours and we will give you a fixed price.

30 minutes, no preparation needed.