Skip to main content

Getting started

Not a developer?

This page is for developers building integrations with our APIs. For help with your Vipps or MobilePay app, account, or business questions, visit the Help Center.

Using a platform? Check plugins first

Before following this custom integration guide, check if we have a ready-made plugin for your platform (Shopify, WooCommerce, Magento, etc.). Plugins handle everything automatically with no coding required.

Integration journey overview​

Follow these steps to integrate Vipps MobilePay into your custom application:

  1. See what's possible – Explore use cases and flows
  2. Become a customer – Sign up and order products
  3. Choose your integration approach – Plugin or custom API integration
  4. Get your API keys – Retrieve credentials for testing
  5. Start testing – Test your integration in our sandbox
  6. Go live – Complete checklists and launch in production

See what's possible​

New to Vipps MobilePay? Start by exploring what you can build:

→ Browse all recommended flows for detailed examples with diagrams.

Become a customer​

If you're a merchant or partner, you can apply for access to Vipps MobilePay services. Remember: you’ll need a separate merchant agreement for each country you want to operate in.

You can even order a product while your merchant agreement is being processed. Products can be added later too — but in some cases, extra risk checks may cause a small delay.

Going deeper

For detailed information about eligibility across countries, cross-border operations, and sales unit management, see Business setup.

Using a platform or need help?​

Check for ready-made plugins first

Before building a custom integration, check if we have a plugin for your platform:

  • Shopify - Payment, checkout, companion app, and login plugins
  • WooCommerce - Full integration with payment and login support
  • Adobe Magento - Complete payment solution
  • All plugins - See all available platform integrations

Plugins handle the API integration automatically and are maintained by Vipps MobilePay or trusted partners.

Need custom development help?​

If you need custom development or your platform isn't covered by our plugins, there are partners who can help. See vippsmobilepay.com: Find a partner to find an option that closely meets your needs.

Find a partner

Get your API keys​

API keys are used for authentication with the API platform. These are credentials that confirm your identity and that your API request is valid.

You'll need API keys for sending requests on behalf of your sales unit.

Each sales unit has a unique set of API keys, so if you have many sales units, you will use different keys for each one.

warning

API keys should be kept secret. Be very careful how you share your API keys. Use encrypted mail or provide other users with minimum access to see the keys for a sales unit in the business portal.

All merchants with API access have access to the test environment (with some exceptions).

A test sales unit is automatically created when a merchant submits an order for a Vipps MobilePay product that includes an API. The details and API keys can then be found in the Developer section in the business portal. See the About the business portal section for details about logging in.

The sales unit will have the same country code as the merchant it is created for. A Norwegian merchant can only create Norwegian sales units, a Danish merchant can only create Danish sales units, and Finnish merchants can only create Finnish sales units.

All Vipps MobilePay customers can create as many sales units as they need in the test environment. Sales units in the test environment cannot be changed.

See:

Start testing​

Once your sales unit is ready, you can begin testing your integration in our test environment.

Complete the applicable API checklists (e.g., ePayment checklist). For partners, there are additional steps.

Test environment essentials​

Read about the test environment

Before you start testing, familiarize yourself with test environment limitations, restrictions, and best practices.

→ Test environment guide

Stopping man

1. Get the test app​

Download the Merchant Test (MT) app to your mobile device:

The test app lets you simulate customer actions and complete payment flows during development.

2. Get your test user​

Merchants need to create their own test users. See Test users for instructions on how to create one.

3. Use the test server address​

To send API requests to the test environment, use this server address: https://apitest.vipps.no

Production server

To work in production, find the API keys for your production sales units. Update the keys in your requests and use the production server: https://api.vipps.no.

Going deeper

For comprehensive testing resources including API key management, authentication details, and Postman collections, see Testing the API.

What's next?​

After completing your integration and testing:

Complete integration checklists​

Each API has a checklist to ensure you've implemented all required features:

Go live in production​

  1. Get production API keys – Find them in the business portal
  2. Update your configuration – Switch from test to production server and keys
  3. Complete final checks – Verify all checklist items are complete
  4. Monitor your integration – Use webhooks and check service status

Need help?​

Rockets
Last updated on