Skip to main content

Merchant portal

How to log in​

Users in Norway, Finland, and Denmark, can log in to the portal with the methods shown below. This is where you can request a merchant agreement and order products.

To become a new customer, create merchant agreement and place your product order, as described in Applying for services.

Once you have an active customer relationship with Vipps MobilePay, you can use the portal as described here. Note, if you are using a PSP, you will only have access if you also have an active customer relationship with Vipps MobilePay.

Merchant portal front page

Log in on portal.vippsmobilepay.com using these methods. If you have problems, check Trouble with portal access.

  • BankID

How to order a product​

To order a product, you need customer relationship with Vipps MobilePay. If you don't have this, you need to register and create a merchant agreement as described on Applying for services.

Once you have a merchant agreement, you can log in on portal.vippsmobilepay.com and select Order solution from the left menu. Select the solution you are interested in and follow the online instructions.

tip

If you already have a cash register solution through a Point of Sales partner, select In-person payments and then look for the Partner integrations option at the bottom of the page. You will get to a form where you can find and select your partner.

Sales units​

How to find the 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.

The API keys include:

  • client_id - Client ID for the sales unit (the "username")
  • client_secret - Client secret for the merchant (the "password")
  • Ocp-Apim-Subscription-Key (primary) - Subscription key for the API product
  • Ocp-Apim-Subscription-Key (secondary) - Subscription key for the API product

You can find the API keys for your test or production sales unit in the merchant portal, portal.vippsmobilepay.com. (Need help logging in?)

  1. Select For developers in the left menu. With the API keys tab selected, you should see a table with sales units.

    The API products for a sales unit

  2. Select either Production or Test, depending on the type of sales unit you are looking for.

  3. Find the sales unit in the table and click the corresponding Show keys button. A panel will open where you can copy the values of each key.

    For example:

    API keys

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

For information about how to use the keys, see API keys.

How to find the Merchant Serial Number​

The Merchant-Serial-Number is a unique identifier that is defined when a sales unit is created. This can be optionally sent in the header for each API request, to aid us with problem-solving.

Find your desired sales unit and the Merchant Serial Number (MSN) is displayed to the right of the sales unit name. You can also find the MSN and other details on the page displayed by clicking the sales unit name or the Show keys buttons.

You can have multiple sales units which can be managed in the portal. You can change the logo, name, or account.

How to create a test sales unit​

For a test sales unit, it is fast:

In the Developer section, select the API keys tab. Select the test environment.

Click Add test sales unit.

Create a test sales unit

Enter the requested properties and click Create.

  • Name - The name of your test sales unit.
  • Partner - Optional partner data (not usually needed).
  • Select optional properties:

After a couple of minutes, your new test sales unit will appear in the bottom of the list (possibly after some browser refreshes). Then, you can get the API keys and begin testing.

note

It is not possible to change an existing sales unit in the test environment, but you can create as many as you need.

How to create a production sales unit​

For a production sales unit, Go to Order solution in the left menu. Select the type of sales unit you want to add. Fill out the necessary information.

This requires some manual work on our end, so please allow up to 10 working days.

How to find a sales unit​

Select For developers from the left menu, and select the API keys tab. You should see a list of sales units.

Select either Production or Test, depending on the type of sales unit.

Find the sales unit name in the table. You can find the MSN and other details for this sales unit.

For production sales units, you can click the name to get more information.

See sales unit info

For production sales units, the name and logo is shown to users in several places, both in the app and elsewhere. You can change these on the sales unit page.

Select For developers from the left menu, and select the API keys tab. Select Production. Click the Edit button beside What your business looks like in Vipps.

Update your name and logo

Note that it is not possible to change the name of a test sales unit.

How to set up Login for your sales unit​

  1. Find your desired sales unit.
  2. Click the Set up login button corresponding to your sales unit.
  3. If this is the first time, click Activate Login then Edit on the Settings section and fill out the fields:

    • Redirect URIs - Specify the URI that will be used with the query parameter, redirect_uri, on the initial request to the authentication endpoint. You can register as many URIs as you want. This creates a list of accepted URIs.

      See Login API FAQ: What are the requirements for redirect URIs for details.

      1. Enter the URI. It must be exactly the same URI that you use when making API requests. Take care to notice if the actual URI is specified with a trailing slash / or not. For testing, you can use http://localhost.
      2. Click Add URI for each URI you add.
      3. Click Save.

Add Login

How to configure marketing consents for Login​

  1. Find your desired sales unit.
  2. Click the Set up login button corresponding to your sales unit.
  3. Click Edit on the Marketing consents section.
  4. Select at least one consent type.
  5. Decide which consents are mandatory.
  6. Add the links to your terms and conditions and privacy statement.
  7. Click Save.

Configure marketing consents

How to add recurring payments​

To request recurring payments, find the sales unit and click Add Billing and Recurring Payments.

In the form that opens, provide an estimate of your revenue and a description of what types of services you will be offering. Estimations are fine, and we will contact your if it's unclear.

Request recurring change form

Once your application is delivered, please expect a few days of processing time. Due to increased risk, we require additional information and evaluations when enabling recurring payments on your profile.

How to deactivate a sales unit​

To deactivate your sales unit, find the sales unit and click the Edit button in the Active field. From there, you can deactivate the sales unit.

Users​

How to find information about a user​

  1. Select User accesses in the left menu.

    See list of registered users

  2. Search for the user's name.

Related sections:

How to check a user's permissions​

  1. Find the user.

  2. Hover over the three dots at the end of the row.

  3. Select Edit permissions and update the permissions, if necessary.

Access permissions in the portal​

  • Administrator: Can edit and view all information, invite users, edit company information, edit settlements accounts and sales units, manage transactions, make refunds, send payment requests, and access and manage API settings.

  • Sales Unit Manager: Can edit sales units, view transactions, and send payment requests.

  • Assistant: Can view information at a sales unit level, view transactions, and send payment requests.

In addition to this, specific permissions can be granted to the Sales Unit Manager and Assistant roles:

  • Transaction Management: Can cancel, charge, refund, and request money for the sales units they have access to.
  • Developer: Can retrieve API keys and set up Vipps MobilePay logs at existing points of sales used for online shopping.

Related sections:

How to create additional users​

Merchants may create user accounts for their colleagues, accountants, partner's employees, or anyone else they want to give access to their sales units.

Partners should use partner keys. If the partner has not implemented partner keys, there will be some manual work: The merchant must retrieve the API keys on portal.vippsmobilepay.com and send them to the partner securely.

If the merchant is unable to provide the API keys to the partner securely, the merchant can create a user for the partner, so the partner can retrieve the API keys.

note

Access is provided for individuals. It is not possible for a merchant to give access to a business (e.g., its partner), only to specific people. There is no limit to the number of people that can be given access.

  1. Select User accesses in the left menu.

    See list of registered users

  2. Select Add user. Enter the new user's phone number.

    Add a user

    The name of the person will automatically be displayed. Click Next.

  3. Select the permissions for the user. A partner's user should include Developer permissions (Access and manage API settings). See Access permissions in the portal for details about the permissions.

    Select the permissions for the user

    Click Next.

  4. Select sales unit(s) the new user will get access to.

    User is added

    Click Complete.

Remember to inform the user when the registration is complete, so they can log in immediately.

Related sections:

How to find a test user​

Select For developers from the left menu, and select the Test users tab. You should see a list of test users. The National Identity Number (NIN), needed for logging-in with the test app, is displayed next to the test user's phone number.

If you don't see your test user's phone number, you should add a new test user. Click Add a new test user, if you have the option. Then user the new phone number and NIN provided. If you have maxed out the number of test users, contact us to request a new test user.

Trouble with portal access​

Check that the user has the correct permissions. See How to check a user's permissions.

If you have general questions about the portal, contact customer service.

I can't log in​

If you don't have one of the logging methods above, or if you don't have access to the correct merchant, you can contact customer service for help.

A workaround is that the merchant's administrator to either:

If you don't know who the administrator is, and you live in Norway, you can check Brønnøysundregistrene, the Norwegian business registry and see who has the right to sign for the business or organization.

I don't see the Developer section​

If you can log in to portal.vippsmobilepay.com, but you can't see the Developer section in the left menu, ask the merchant's administrator to How to check a user's permissions for the sales unit (Assistant + Access and manage API settings).

Partners​

How can I see which partner is selected for a sales unit​

Navigate to the sales unit information. Under Your solution look for Your integration partner to find the name of the partner. If the sales unit is not linked to a partner the section, Your integration partner will not be shown.

See partner information on sales unit

How can I change partner for a sales unit​

It is not possible to change partner through the portal. We have made a guide for how to handle this here.

Is it possible to have two partners for one sales unit​

You can only select one partner for each sales unit. However it is possible to select one partner for your sales unit, and share your API keys with a different partner. We do not recommend this approach because it means that both partners will have access to the sales unit and can access and effect the same data. If you choose to do this please inform both partners that another partner have access as well. The recommended approach is to create a new sales unit for each partner.

QR codes​

How to generate a Vipps MobilePay branded QR code​

tip

You can also generate these QR codes via the QR API: Merchant redirect QR codes.

First, find Scan and pay in the sidebar.

Find Scan and Vipps in the menu

Then, select the sales unit you want to use, and click Create a new QR code.

Enter the name you want for the QR and the URL.

"Choose a name and a URL for the QR"

Click Create new QR-code.

The QR code is created, and you can download it in either SVG or PNG. "Download the QR or change the URL"

Portal FAQs​

There are several FAQs available on vipps.no. These are not yet available in English, but will be soon. For example, see:

Help us improve our documentation

Did you find what you were looking for?