Skip to main content

Loyalty at the Point of Sale

How it works

Vipps Loyalty at Point Of Sale (POS) is a solution that combines multiple Vipps products and makes a great product-market fit for retail stores that want to combine loyalty with payments. It's a great way to improve the payment experience for customers and simplify the process of adding customers to the merchant loyalty club.

The solution is a combination of the personal QR codes in the Vipps app, the Vipps Login API, the Vipps ePayment API, and the Vipps Check-in API.

The following describes the Loyalty at the POS process at a high-level.

Loyalty Flow

Step 1: Scan the QR code

The flow begins with the customer presenting their QR code to the merchant. This can happen in two ways:

  • Customer-facing scanner - The store will have a permanent customer-facing scanner and customers can scan their QR code at any time.
  • Cashier scanner - The QR code is scanned by the cashier using a wired scanner. This could happen while the cashier is scanning wares or immediately before the payment.

Loyalty Flow

The customer's personal Vipps QR code contains a URL like this: https://qr.vipps.no/28/2/01/031/4791234567?v=1, where 4791234567 is their phone number in MSISDN format.

When the customer's Vipps QR code is scanned in the store, the POS will get their phone number. This can be used for checking membership, in the next step.

Step 2: Check membership

Check the customer's membership status by using the phone number you received in the previous step.

Use the Vipps Check-In API and the POST/v1/loyalty-check-in endpoint to trigger a "waiting screen" in Vipps to inform the customer whether or not they are a member of your loyalty program. This will help them through the payment process.

If the customer is a not member, proceed to step 3 where you can enroll them by using Vipps Login.

If they are already a member, skip to step 4.

Loyalty Flow

Step 3: Request membership (optional)

If the customer is not a member of the loyalty program, you can request to enroll them by using the Vipps Login API.

You already have their phone number from step 1, so just provide a button in your user interface to allow the cashier to initiate the login.

Pressing the button will trigger a Vipps Login flow to gather consent from the customer. When this login flow is completed, the customer will be enrolled in the loyalty program.

Loyalty Flow

Step 4: Send a payment request

After membership status has been determined and all wares have been scanned, send a payment request to the customer.

You already have the phone number from step 1, so just provide a button in your user interface to allow the cashier to send the payment request. A notification will appear on the customer's Vipps app.

Once they authorize the payment, the POS will be updated with the status.

Loyalty Flow

For a detailed step-by-step guide for how to implement Loyalty at the POS, see the Quick Start guide.