In-person payments

Choose your scenario based on your point of sale setup:

• Customer-facing screen - You have a screen where you can display a dynamic QR code
• QR scanner - You have a 2D scanner to read the customer's personal QR code
• POS - manual entry - You have a manned point of sale where the cashier enters the phone number
• Static QR - You have an unmanned point of sale like a vending machine or trust shop

Customer-facing screen ⭐

You have a screen at checkout that faces the customer (like a tablet, monitor, or payment terminal display).

You generate and display a unique QR code for each transaction. The customer scans it with their Vipps MobilePay app to pay.

1. Generate QR - Create a dynamic QR code and payment request via ePayment API.
2. Display QR - Show the QR code on the customer-facing screen.
   
3. Customer scans and authorizes - Customer scans QR and approves payment in their app.
4. Capture payment - Confirm the transaction is complete.

View sequence diagram

Dynamic QR directing to the app

For more information, see:

• How to make one-time payment QRs

QR scanner

You have a 2D QR scanner at your checkout (the kind that can scan codes from a phone screen).

The customer opens their personal QR code in the Vipps MobilePay app, you scan it to identify them, then send the payment request to their app.

1. Register products - Add items to the POS system.
2. Scan customer's QR - Scan their personal QR code to identify the customer.
3. Send payment request - Initiate payment using the ePayment API with PUSH_MESSAGE.
4. Customer authorizes - Customer approves payment in their app.
5. Capture payment - Confirm the transaction is complete.

View sequence diagram

QR scanner payment flow

Technical details:

• Personal QR
• ePayment API guide

POS-manual entry

You have a manned checkout where cashiers can enter information manually.

The cashier asks for the customer's phone number, enters it into your POS system, then sends the payment request to their Vipps MobilePay app.

1. Register products - Add items to the POS system.
2. Get customer phone - Manually enter the customer's phone number.
3. Send payment request - Use the ePayment API to initiate payment with PUSH_MESSAGE.
4. Customer authorizes - Customer approves payment in their app.
5. Register payment - Update the POS system with payment status.
6. Capture payment - Confirm the transaction is complete.

View sequence diagram

POS manual entry payment flow

Technical details:

• How ePayment works in the store

Static QR

You have an unmanned location (like a vending machine, trust shop, or self-service kiosk) with no special hardware.

Choose between two types of static QR codes:

Merchant Redirect QR

Display a printable static QR code that redirects customers to your website when scanned. Works with any phone camera - the Vipps MobilePay app is not required. The QR never expires.

Use this when you want to direct customers to your website for product selection and payment.

1. Customer scans QR - Customer scans the static QR code with their phone camera.
2. Redirect to website - Customer is taken directly to your website.
3. Customer shops - Customer browses your website and selects products.
4. Customer initiates payment - Customer chooses to pay with Vipps MobilePay.
5. Send payment request - Merchant initiates payment through the ePayment API.
6. Customer authorizes - Customer approves payment in their app.
7. Capture payment - Confirm the transaction is complete.

View sequence diagram

Static QR directing to the merchant site

Technical details:

• Merchant redirect QR code

Merchant Callback QR

Display a printable static QR code that sends a callback to your system when scanned. Best for self-checkout, vending machines, or unmanned locations where you need to know when a customer is ready to pay.

When scanned with the Vipps MobilePay app, you receive a customer token via webhook. You then initiate a payment that reserves the price of the most expensive item, customer makes their selection, and you capture only the actual amount.

1. Customer scans QR - Customer scans the static QR code with the Vipps MobilePay app.
2. Callback received - Your system receives a webhook notification with a customer token.
3. Initiate payment - Send payment request for the most expensive item's price via ePayment API.
4. Customer authorizes - Customer approves the payment in their app.
5. Customer selects product - Customer makes their selection on the vending machine.
6. Partial capture - Capture only the actual amount for the selected product.
7. Cancel remaining - Release the remaining authorized amount.

View sequence diagram

Static QR directing to the Vipps MobilePay app

Technical details:

• Merchant callback QR code
• Subscribe to user.checked-in.v1 webhook - Required to receive scan notifications

Explore the other ePayment flows in this section. When you are ready to learn about the technical details, go to the ePayment API guide.