Getting started

If you need help with your account or with the app, please contact us at help.vippsmobilepay.com.

Vipps and MobilePay are both owned by Vipps MobilePay .

Get familiar with the options

If you are completely new to Vipps MobilePay, you might look at some of the scenarios that you can achieve. See Recommended flows.

Become a customer

As a merchant or partner, you can apply for access to Vipps MobilePay services. You'll need separate merchant agreements for each country you want to operate in.

You can order a product while your merchant agreement is still being processed. You can also add products later, but note that there might be a small delay if additional risk evaluations are required.

For details, see Apply for services.

Get help with the programming?

If you don't want to do the programming yourself, there are partners and open-source plugins that may be helpful. See vippsmobilepay.com: Find a partner to find an option that closely meets your needs.

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 portal at portal.vippsmobilepay.com.

Merchants

All merchants with API access have access to the test environment.

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 on portal.vippsmobilepay.com. See the 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 merchants.

How to find the API keys

1. Go to For developers in the sidebar. (If you don’t see this, tell your Administrator that you need Developer access).

2. In the API keys tab, select either Production or Test, depending on your sales unit type.

3. Find the sales unit in the table.

   

4. Click the corresponding Show keys button. A panel will open where you can copy the values of each key.

   

Use caution with storing and transferring API keys

API keys are sensitive information, so handle them carefully:

• Vipps MobilePay will never ask for your API keys, and you must keep them secret.
• Always send API keys by encrypted email.
• Merchants: If you accidentally share your API keys, you must generate new ones by clicking the regenerate button on your portal.vippsmobilepay.com page.
• Partners: For keys other than merchant API keys, contact the partner team. For merchant keys, the merchant needs to generate new ones on the portal.
• Update your integrations, so they will continue working.

If you need to transfer the API keys to someone, be sure to do it securely. If they can't be moved securely, you can create a portal user for that person and give them basic access to the sales unit.

For partners

A Vipps MobilePay partner should use Partner keys, and not the merchant keys. If a partner can't get partner keys, there are two solutions:

1. The merchant can download the API keys and send them to the partner securely.
2. If the merchant is unable to provide the API keys to the partner securely, they can add a production user for the partner and give them Assistant access. Then, the partner can log in to the portal and download the API keys.

All Vipps MobilePay customers can create as many sales units as they need in the test environment. Sale units in the test environment cannot be changed. See: How to create a test sales unit.

Partners

Once your partner application has been approved, you'll receive a welcome email with a test sales unit and API keys. If you have lost this or need a new test sales unit, please contact partner@vippsmobilepay.com. Sales units are unique per country. Remember to state which country the sales unit should be created for.

Note that partner functionality is not available in test. Instead, you will receive merchant API keys, as mentioned in the limitations section. All payment and login flows can be tested using the merchant API keys.

Partners can also get access to the test environment by ordering the Login API. See Partner: How to get access to your sales units on the portal.

Start testing

If you have ordered an online service, you'll be using the API platform to integrate Vipps or MobilePay into your website or system.

Once your sales unit is ready, you can start testing the applicable API endpoints and complete the corresponding checklists (e.g., ePayment checklist). For partners, there are additional steps.

important

Please read about the test environment.

Get the test app

See Merchant Test (MT) app to find out how to download the app.

See the Test environment page for test environment limitations, test servers, test apps, and much more.

Get your test user

If you were not sent a test user, you should read about how to create one from the test environment page.

Use the test server address

To send API requests to the test app, you'll need to 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.

Try a quick start guide

Each API has a quick start guide to help you get started. Find the one that is most relevant for you:

• ePayment quick start
• Recurring quick start
• Login quick start
• Checkout quick start