Vipps MobilePay Gateway

The Vipps MobilePay gateway lets you accept phone-based payments directly within WCPOS. 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 WCPOS

1. Go to WP Admin > POS > Settings > Checkout
2. Find the WCPOS 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 — Send to Phone

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 or is directed to the Vipps landing page, then confirms payment in their app
6. Automatic Completion: The order completes automatically once payment is authorized

The plugin automatically detects the best method for sending the payment request to the customer's phone:

• Direct push (preferred) — Sends a notification straight to the customer's Vipps app. This is the fastest experience but requires Vipps to enable PUSH_MESSAGE on your sales unit (see Enabling Direct Push below).
• Landing page fallback — If direct push isn't enabled, the plugin opens the Vipps landing page in a new browser tab. The landing page handles sending the notification. This works immediately with no special approval.

The first time the plugin detects that direct push isn't available, you'll see a brief message asking you to click "Send to Phone" again. After that, it remembers the result and works seamlessly.

Enabling Direct Push

The direct push flow provides the best experience for phone payments — no extra tabs, no landing pages. To enable it:

1. Log in to portal.vippsmobilepay.com
2. Contact your Vipps key account manager, partner manager, or customer service
3. Tell them: "I need PUSH_MESSAGE enabled on my MSN for use with a POS integration"

Once approved, the plugin detects the change automatically within 24 hours and switches to the direct push flow. You'll see a reminder notice on the gateway settings page while you're using the landing page fallback.

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

WCPOS: 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

'Send to Phone' opens a new tab instead of sending directly

This means your Vipps account doesn't have PUSH_MESSAGE enabled yet. The plugin is using the landing page fallback, which works but adds an extra step. To get the smoother direct push experience, contact Vipps and ask them to enable PUSH_MESSAGE on your sales unit (MSN). See Enabling Direct Push above.

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