Knowledge base

Here you will find a collection of information for setting up Vipps and MobilePay as a payment or login provider for your store or website.

For help with the Vipps app, see vipps.no.

For help with the MobilePay app, see mobilepay.dk or mobilepay.fi.

👉 If you are just starting out, check out the Getting started guide.

General information

Applying for services - The process and requirements for applying for Vipps MobilePay services.
Across borders - Learn about using Vipps MobilePay in other countries.
Direct integration and PSP integration - Differences between integrating the Vipps MobilePay APIs directly or implementing the PSP API.
Point of Sale integrations - About setting up a PoS integration.
API lifecycle - General advice about API versioning and deprecation.
Merchant questions - Typical questions asked by merchants.
Maintenance window - When is Vipps MobilePay offline for maintenance?
Settlements - How settlements are processed by Vipps MobilePay.
Terminology - Vipps MobilePay terminology, including special terms from Danish, Finnish, and Norwegian.

API keys - Find out what API keys are and how to get your API keys.
Test environment - How to set up for testing the Vipps MobilePay APIs.
Authentication - How to get authentication for API requests.
HTTP headers - Headers to use in all your API requests.
HTTP response codes and errors - HTTP statuses returned in API responses and the standard response body format for our error messages.
Landing page - The landing page which opens in a browser and prompts the user to enter their phone number.
QR codes - Different types of Vipps MobilePay QR codes.

Payments - The payment request screen and receipt details in the Vipps MobilePay app. Payment use cases, success rates, card payments, and common problems.
Reserve and capture - The difference between reserving and capturing a payment.
Cancellations - Ways to cancel a payment.
Refunds - About payment refunds.
Timeouts - Standard timeouts for payment requests.

isApp - The isApp payment flow in the eCom and Recurring API.
Payment description and transaction text - Recommendations for payment description and transaction text.
Polling guidelines - Guidelines for using polling.
Redirects - Guidelines for how to redirect users to your website after a purchase.
Reference and orderId - Recommendations for reference and orderId.
URL validation - Details surrounding URL validation in the eCom and PSP APIs.

Status pages - Get notifications about disruptions in Vipps MobilePay services.
Merchant portal - Git tips about logging into the portal for getting API keys and managing sales units.
Servers - Get server addresses for making Vipps MobilePay API calls.
Demo store - Test out the different payment flows with a real Vipps or MobilePay app.

If you aren't sure what to do next, see the Getting started page.