Choosing the right QR type

Pick the QR type that matches your hardware setup:

QR Type	Best For	What You Need
One-time payment QR	Self-service kiosk	Customer-facing screen
Merchant redirect QR	Marketing materials	Just print it!
Merchant callback QR	Vending machine, unmanned	Webhook endpoint
Personal QR	Staffed checkout	2D QR scanner

One-time payment QR

Use when: You have a screen where customers can see a QR code (terminal, kiosk, display).

You display a QR on your screen → Customer scans it → They approve payment. Each QR is unique to that transaction.

Quick start:

1. Create payment with ePayment API, set userFlow: "QR"
2. Display the returned QR image on your screen
3. Get payment status via webhook or polling

See implementation details →

---

Merchant redirect QR

Use when: Marketing materials, posters, product packaging—anywhere you want to direct people to your website.

Print a QR code → Customer scans with any camera → Your website opens. Works with any phone, not just Vipps/MobilePay.

Quick start:

• Via API: Generate with POST:/v1/merchant-redirect
• No code: Create in the portal (how to)

See implementation details →

---

Merchant callback QR

Use when: Unmanned locations like vending machines, parking meters, or self-checkout.

Print a QR sticker → Customer scans it → You get a notification → You send them a payment request. The same QR can be used repeatedly.

Quick start:

1. Generate QR: POST:/v1/merchant-callback
2. Set up webhook to receive scan notifications
3. When scanned, create payment with the customerToken from the callback

See implementation details →

---

Personal QR

Use when: You have a 2D scanner at checkout (handheld or customer-facing).

Customer shows their QR code from the Vipps or MobilePay app → You scan it → They approve payment in their app. No phone number needed.

Quick start:

1. Scan the QR code
2. Exchange it for a phone number: POST:/v1/exchange
3. Create payment with the ePayment API

See implementation details →

---

Still not sure?

Have a screen? → One-time payment QR (best option)
Just marketing? → Merchant redirect QR
Unmanned location? → Merchant callback QR
Have a scanner? → Personal QR

You can use multiple types simultaneously—many businesses combine One-time payment QR (self-checkout) with Personal QR (staffed lanes).

Common questions

Can I use multiple types? Yes, they work independently.

Do I need separate API keys? No, one set works for all QR types.

Which is fastest? One-time payment QR (screen) is fastest. Personal QR (scanner) is also fast.

Which works with any phone? Only Merchant redirect QR. Others need the Vipps/MobilePay app.

Do QRs expire? One-time payment QRs expire in 5 minutes. Others are permanent.

Next steps

• QR API guide - Complete implementation guide
• Recommended flows - Real-world examples