Vipps MobilePay Gateway

The Vipps MobilePay gateway lets you accept phone-based payments directly within WooCommerce POS. Customers pay by scanning a QR code on screen or confirming a push notification on their phone — no card reader hardware needed.

Features

QR Code Payments

Display a QR code at checkout for customers to scan and pay with their phone

Push Notifications

Send a payment request straight to the customer's phone by entering their number

Nordic Coverage

Works with Vipps in Norway, MobilePay in Denmark and Finland

Auto Capture

Capture funds immediately after authorization, or reserve for manual capture

Installation

1

Download and Install

1. Visit the WCPOS Vipps MobilePay releases page
2. Download the latest wcpos-vipps.zip file
3. In your WordPress admin, go to Plugins > Add New > Upload Plugin
4. Upload the zip file and activate the plugin

2

Configure Vipps Credentials

1. Navigate to WP Admin > WooCommerce > Settings > Payments
2. Find WCPOS Vipps MobilePay in the payment methods list
3. Click on WCPOS Vipps MobilePay to access settings
4. Enter your credentials from the Vipps Portal:
   • Merchant Serial Number (MSN)
   • Client ID
   • Client Secret
   • Subscription Key
5. Save the settings

note

You don't need to enable the gateway here for POS use — it will be enabled specifically for the POS in the next step. Enabling it in WooCommerce settings would also make it available on your online store checkout, which can be useful for testing.

Already using the Vipps plugin?

If you have the official Checkout with Vipps MobilePay plugin installed, your credentials will be imported automatically when you activate this plugin. You can skip the manual credential entry.

3

Enable in WooCommerce POS

1. Go to WP Admin > WooCommerce POS > Settings > Checkout
2. Find the Vipps MobilePay gateway in the list
3. Enable the gateway for use in the POS
4. Save your settings

Usage

Processing Payments — QR Code

1. Add Items: Add products to your cart in the POS
2. Select Gateway: Choose "Vipps MobilePay" as the payment method
3. Generate QR Code: Click the "Generate QR Code" button
4. Customer Scans: The customer scans the QR code with their Vipps or MobilePay app
5. Customer Confirms: The customer confirms payment in their app
6. Automatic Completion: The order completes automatically once payment is authorized

Processing Payments — Push Notification

1. Add Items: Add products to your cart in the POS
2. Select Gateway: Choose "Vipps MobilePay" as the payment method
3. Enter Phone Number: Type the customer's phone number
4. Send to Phone: Click the "Send to Phone" button
5. Customer Confirms: The customer receives a push notification and confirms payment in their app
6. Automatic Completion: The order completes automatically once payment is authorized

Cancelling a Payment

While waiting for the customer to confirm, you can click the Cancel Payment button to abort the transaction. This cancels the pending payment on the Vipps side and resets the checkout interface.

Refunds

Refunds are handled through the standard WooCommerce refund process. Open the order, click Refund, enter the amount, and the refund is processed through the Vipps API automatically.

Supported Markets

Vipps MobilePay operates across the Nordic region under two brands:

Region	Brand	Currencies
Norway	Vipps	NOK
Denmark, Finland	MobilePay	DKK, EUR

Your merchant account determines which markets and currencies are available. Customers in any supported market can pay using their local Vipps or MobilePay app.

Requirements

Vipps Account: Active Vipps MobilePay merchant account with API credentials

API Credentials: Merchant Serial Number, Client ID, Client Secret, and Subscription Key

WooCommerce POS: Pro version required for POS checkout. The gateway also works on the standard WooCommerce web checkout without Pro.

HTTPS: Your site must use SSL/HTTPS (required by the Vipps API)

Troubleshooting

Common Issues

Payment not completing

• The checkout polls for up to 5 minutes — if the customer doesn't confirm within that window, the payment times out
• Check that you're not mixing up test mode and production credentials
• Verify your internet connection is stable on both the POS device and the customer's phone

Invalid credentials error

• Double-check all four credential fields (MSN, Client ID, Client Secret, Subscription Key)
• Make sure you're using test credentials when test mode is enabled, and production credentials when it's disabled
• Verify your credentials in the Vipps Portal

QR code not generating

• Confirm your site is running over HTTPS — the Vipps API rejects requests from HTTP sites
• Check the WooCommerce logs (WooCommerce > Status > Logs) for API error details
• Verify your merchant account is active and has the ePayment API enabled

Getting Help

For technical support:

• Visit the GitHub repository to report issues
• Check the Vipps developer documentation for API-related questions
• Contact Vipps MobilePay support for account and credential issues

Screenshots

Screenshots will be added in a future update to show:

• Gateway configuration in WooCommerce payment settings
• POS checkout interface with QR code and push notification options
• Payment confirmation flow