Test environment

If you need help with your account, please reach us through the Vipps MobilePay help pages.

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 users
2. Test sales units
3. Test apps
4. API keys
5. Test server

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.

Your test user must be in the same market and currency as the sales unit. If you need another 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, when you have an active customer relationship. See How to log in for more information.

To create additional users, select User accesses in the sidebar and select Add user. For more details, see create additional users.

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. You can also specify a birthdate.
• There is no way to get a test user with specific attributes, other than age, since it's randomly generated.
• There is no way to change an existing test user.
• There is no way to get a test user in the production environment. The production environment only contains real users and data.
• Test users are connected to a market (i.e., Norwegian market). For now, users must be on the same market as the sales unit.

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 CPR-nummer / personnummer.

In Finland, NIN is called henkilötunnus.

In Norway, NIN is fødselsnummer / personnummer.

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 sales units

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.

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.

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.

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 test app!

Install on Android

The Android test app is available for everyone in Firebase App Distribution. Enter the email address that is associated with your Google account. You will receive an email with an activation link.

1. Open the Firebase App Distribution link on your Android phone (it will not work on a PC/Mac) and download the app.
   
   If you get a prompt to install unknown apps, temporarily enable this and click Run.
2. Install and open the Vipps MT app.
3. Choose the country corresponding to 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 your 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. Allow notifications.

You are now ready to use the 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 API keys are linked to a specific test sales unit and can only be used for this unit.

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 are normally available a few minutes after the test sales unit is created.

For details about the keys, including how to find them, see API keys.

Test server

Test (MT) server: https://apitest.vipps.no

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.

Incidentally, the production server is: https://api.vipps.no. For more information, see Servers.

Useful information

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

Refund test amounts

Amount	Error
1.23	Cannot refund single transferred payments (This error indicates that the user is deleted or does not have a receiving account)
1.24	Refund period expired

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 app still looks like Vipps , but the APIs and flows are the same and can be fully tested for MobilePay markets.
2. Freestanding card payments (in the ePayment API).
3. Order management.
4. 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.
5. The activity list is empty and old payments cannot be found.
6. Partner functionality and the use of partner keys is not available. Partners will receive merchant keys for test.
7. The Management API is not available.
8. 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.
9. There is no equivalent to portal.vippsmobilepay.com for the test environment.
10. 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.