Test environment

All partners and customers with access to the APIs have access to the test environment (also called "MT" for Merchant Test environment).

To access the test environment, you need:

1. Test user
2. MT Test app
3. API keys

The test environment is available for Vipps and MobilePay, with the limitations below.

Test users

A test user's credentials consist of a phone number and a national identity number.

If you don't have a test user, see Creating a test user.

Creating a test user

Test users can't be created through the app, but must be retrieved as follows.

Merchants

Test users can be created and retrieved on portal.vippsmobilepay.com, but you will need an active customer relationship. See How to log in for more information.

To create additional users, select User accesses in the left menu and select Add user.

Partners

Once your partner application have been approved, you will receive a welcome email with a test user (the email also includes your API keys). Note that you need both the phone number and national identity number. If you have an older user and do not have the national identity number, please contact partner@vippsmobilepay.com to request a new test user.

Please be aware that:

• The same test user can be used on multiple devices and networks.
• Test users are not connected to any merchant or partner. They can be used with any merchant and sales unit in the test environment.
• The test user's name, birthdate, etc. are randomly generated when the test user is created and cannot be changed. There is no way to get a test user with specific attributes, like age, since it's randomly generated.
• There is no way to get a test user in the production environment. The production environment only contains real users and data.

note

It is not possible to get a test merchant or test user in production. The only way to test in production is to onboard as a merchant and order a product. This requires going through the mandatory compliance checks and making real transactions with a user, using the production app. We recommend performing as much testing as possible in the test environment instead.

National Identity Number

A fictitious National Identity Number (NIN) is randomly generated when the user is created. This is needed for logging in with the test app.

What is NIN?

The National Identity Number (NIN) is the identification number given to people by their national government for official use.

In Denmark, the NIN is called Personnummer or CPR-nummer.

In Finland, NIN is henkilötunnus.

In Norway, NIN is fødselsnummer or d-nummer.

In Sweden, NIN is personnummer.

Phone number

You will be provided a phone number to use in the test environment.

warning

Do not use this phone number in the production environment, because it could belong to a real user.

Payment card

The test user is registered with a payment card, and it is not possible to add new cards in the test app.

Email address

You can add a real email address on a test user from the Profile Personal information Email section in the app.

In the test environment, verification of emails can only be triggered in a Login flow (if the merchant requests the email scope), or from clicking send email from the email address section under the profile page. After updating the email address, you will need to close and reopen the app for this option to be available.

Just updating the email and saving it will not trigger an email to be sent for verification. The indication on the profile page that the email is not verified can be ignored.

Test apps

The test apps for iOS and Android are similar to the production apps (we aim to keep them as identical as possible). They connect to the Merchant Test environment (MT) instead of the production environment, so you can use them with test users to test out the flow with API requests.

A test app can be installed on the same phone as a production app without conflicts, as it uses the vippsMT:// URL scheme, while the production app uses vipps://.

note

Only test users, with random fake phone numbers, are available in the test environment. Normal (real) users are not available, so you can't use your own phone number with the test apps.

Don't use the test phone number in the production environment, as it may belong to a real person. 💸

App installation

Install on iOS

The iOS test app is available in Apple TestFlight. You don't need an invitation or an activation code. If TestFlight request this please close TestFlight and access it again through the link below.

1. Open the TestFlight link on your iOS phone (it won't work on macOS, and the TestFlight search is not helpful).
   

   
2. Install and open the Vipps MT app.
3. Choose the country. It must be the corresponding country for your test user or the next step will fail.
4. If prompted with age check please choose "Above 15"
5. Enter the national identity number for the test user.
6. Enter the test phone number for the test user. Your normal Vipps or MobilePay user is not available in the test environment.
7. On the Verify your number screen: Use PIN 1236. We allow 10,000 incorrect PIN attempts before locking the user's account.
8. Click Next to confirm with electronic ID. A web view/browser will open and close shortly after. Please disregard this, it only imitates the eID verification users are prompted to complete in production.
9. On the Enter your code screen: Use PIN 1236.
10. Enable Touch ID and confirm with PIN 1236.
11. Accept push notifications.

You are now ready to use the iOS test app!

Install on Android

The Android test app is available for everyone in App Center. You don't need an invitation or an activation code.

1. Open the App Center link on your Android phone (it will not work on a PC/Mac).
   

   
   If you get a notification prompting to whitelist the source, do this in your Settings.
2. Install and open the Vipps Android app.
3. Choose the country. It must be the corresponding country for your test user or the next step will fail.
4. If prompted with age check please choose "Above 15"
5. Enter the national identity number for the test user.
6. Enter the test phone number for the test user. Your normal Vipps or MobilePay user is not available in the test environment.
7. On the Verify your number screen: Use PIN 1236. We allow 10,000 incorrect PIN attempts before locking the user's account.
8. Click Next to confirm with electronic ID. A web view/browser will open and close shortly after. Please disregard this, it only imitates the eID verification users are prompted to complete in production.
9. On the Enter your code screen: Use PIN 1236.
10. Enable Touch ID and confirm with PIN 1236.
11. Accept push notifications.

You are now ready to use the Android test app!

Using other versions of the app

It may sometimes be necessary to use specific app versions in MT. This happens when the production apps and the production environment are not quite in sync with the test environment. When this happens, we update the Status page for the test environment with details.

Using an emulator

If you use an app emulator, and not the native apps installed on a real phone, you may experience problems - including having to log in from scratch every time you start the app in the emulator.

API keys

The test environment and production environments are completely separate. You will, therefore, need to use a different set of API keys for the test environment versus the production environment.

• API keys for the test environment: Normally available a few minutes after the sales unit is created. See How to create a test sales unit for details.
• API keys for the production environment: Normally available after a few days after application, depending on the workload and whether we need additional information.

warning

Use caution with storing and transferring API keys.

• 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.

The API keys are linked to a specific test sales unit and can only be used for this unit.

note

Sales units in the production environment must follow strict rules (regulatory and other), so you may not be able to get the same sales unit configuration there, even though you have it in the test environment.

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 Merchant 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

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.

   

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:

   

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.

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 merchant portal.

Test server

The test and production environments are separate and require different API credentials:

The servers are accessible around the world. Vipps MobilePay only relies on the API keys, and no requests to our servers are blocked on our side by IP addresses or similar.

Production server:

api.vipps.no

Test (MT) server:

apitest.vipps.no

For more information, see Servers.

Test amounts

The test environment supports using special amounts in the test app to trigger certain test cases. Use these amounts to always get the same result.

Amount	Error
1.51	Insufficient funds
1.82	Refused by issuer
1.83	Suspected fraud
1.84	Withdrawal limit exceeded
1.86	Expired Card
1.87	Invalid card
1.97	3D Secure denied
2.01	Unknown result for 1 hour
2.02	SCA required

MobilePay facade test

Please read the facade documentation for information on how to test these in the test environment:

• MobilePay App Payments
• MobilePay Subscriptions
• MobilePay Online

Limitations of the test environment

In general, MT does not contain functionality that requires integration with third parties. Most but not all APIs are available in MT.

note

There is no SLA or uptime guarantee for the test environment. We will not make any fixes, etc. outside typical office hours (CET) and unscheduled maintenance may occur. See the Status page for automatically updated status information.

Functionality that is not available in the test environment, a non-exhaustive list:

1. The test environment doesn't fully support the MobilePay markets yet. Everything still looks like but the APIs and flows are the same and can be tested. For now, you will see that the test app only has the orange Vipps color scheme, not the blue MobilePay color scheme.
2. Freestanding card payments (in the ePayment API).
3. Push alerts may be unavailable or unstable. To see payment requests: Click the Payments button at the bottom, and then pull to refresh on the Payments screen.
4. The activity list is empty and old payments cannot be found.
5. Partner functionality and the use of partner keys is not available. Partners will receive merchant keys for test.
6. The Management API is not available.
7. The Report API is not available. And there are no settlements in the test environment, and therefore no settlement reports. The only way to test the complete settlement flow is in the production environment.
8. There is no equivalent to portal.vippsmobilepay.com for the test environment.
9. The user's email address can't be verified in the normal way. See: Email address.

To test functionality that is not available in MT, you will have to use the production environment in a controlled manner, using a real user and a real merchant.