Skip to main content

The Vipps Test Environment (MT)

The Merchant Test Environment (MT) is available for all Vipps merchants with API access.

About the test environment

All Vipps customers with access to Vipps På Nett, Vipps Faste Betalinger and Vipps Logg Inn have access to the test environment.

Important: There is no SLA or uptime guarantee for the test environment. Vipps will not make any fixes, etc. outside of typical Norwegian office hours. See the Status page for automatically updated status information.

The test environment is suitable for testing most of the Vipps functionality, but some functionality in the production environment is not available in MT. In general, MT does not contain functionality that requires integration with third parties.

The test and production environments are completely separate and use different API keys.

Please note: For production, Vipps only offers Direct capture for merchants that use Vipps through a partner. In the test environment, you can do this by creating a sale unit where direct capture is allowed.

Limitations of the test environment

Functionality not available in MT (a non-exhaustive list):

  • Unscheduled maintenance may occur. We will do our best to inform with Status page, but it may no always be possible. In practice this is extremely rare.
  • Push alerts may be unavailable or unstable. To see payment requests: Open Vipps and manually go to the "Betalinger" (i.e., Payments) at the bottom of the main screen. The background for this: The app id for the test and production apps are the same, and we are not able to distinguish between the apps when sending push messages.
  • Payment of invoices, both for Vipps Regninger and Vipps Faktura
  • Limited support for testing card statuses that require connections our PSP
  • Limited support for looking up customer information in KAR, etc
  • Some quirks around email verification, see Email address.

To test functionality that is not available in MT, you will have to use the production environment in a controlled manner. One example may be to test Vipps Regninger with real invoices, but with small amounts. We recommend 2 NOK.

Other differences between Production and MT:

  • There is no equivalent to portal.vipps.no for the test environment. Payments must be checked with the API, as there is no web interface.
  • We allow 10,000 incorrect PIN attempts before locking the Vipps user's account
  • There are no settlement reports and no SFTP service.

Access to the test environment

Merchants

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

A test sale unit is automatically created when the merchant submits an order for a Vipps product (that has an API), and the details can be found on the "Utvikler" (developer) section on portal.vipps.no.

See:

Partners

Partners can get access to the test environment by ordering "Vipps Logg inn" (the Vipps Login API) on portal.vipps.no.

The partner must also:

  1. Explain in the order form that it is only for access to the test environments
  2. Notify their partner manager that they only need test access.

Since "Vipps Logg inn" does not require the same regulatory checks (KYC, AML, etc), this is a quick process.

Test server

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

Production (Prod)Test (MT)
api.vipps.noapitest.vipps.no

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

See Vipps servers for more information.

Test merchants

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.

All Vipps customers can create sales units ("merchants") in the test environment.

See:

Please note: Sale units in the production environment must follow strict rules (regulatory and other), so you may not be able to get the same sale unit configuration (like "direct capture") there, even though you have it in the test environment.

Test users

A welcome email is automatically sent to all new customers. This email contains information about your test user. The subject should contain "Kom i gang med Vipps". Please search your mail, including the spam/junk folder, if you do not find it.

Please note:

  • The provided test user can be used in the Vipps test apps.
  • You must log in with the test user in the test app, before you can complete payments for that user.
  • You may use the same test user on multiple devices.
  • Test users are not connected to any merchant, they can be used with any merchant and sale unit in the test environment.

If you need more than one test user, please contact your Key Account Manager (if you have one), your partner contact (if you have one), or contact customer service.

There is no way to get a test user in the production environment. The production environment only contains real users and data.

Phone number

The test user has everything required to complete a payment. The test user's mobile number works on all phones and on all networks.

Important: Do not use the test phone number in the production environment, as the test number may be a real phone number for a real Vipps user.

Payment card

The test user is registered with one payment card.

If you need additional payment cards, you can add it in the Vipps app.

Email address

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

Please note: In MT verification of emails can only be triggered in a Vipps Login flow (if the merchant requests email), or from clicking “send email” from the email address section under 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 storing 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.

Other data

The test user's name, birth date, etc. are randomly generated when the test user is created and cannot be changed.

Test amounts

Vipps supports using special amounts in the Vipps test app. Use these amounts to always get the same result.

AmountError
1.51Not sufficient funds
1.82Refused by issuer
1.83Suspected fraud
1.84Withdrawal limit exceeded
1.86Expired Card
1.87Invalid card
1.973D Secure denied
2.01Unknown result for 1 hour
2.02SCA required

Please note: The force approve endpoint does not support this functionality.

Vipps test apps

The test apps for iOS and Android are identical to the production apps, but connect to the Vipps test environment (MT) instead of the production environment.

The test apps can be installed on the same device as the production apps without conflicts. The test apps use the vippsMT:// URL scheme, and the production apps use vipps://. See installation instructions below.

Only test users, with random "fake" phone numbers, are available in the test environment. Normal Vipps users are not available, so you cannot use your own phone number with the test apps.

Important: Do not use the test phone number in the production environment, as the test number may be a real phone number for a real Vipps user.

Install Vipps MT on iOS

The iOS test app is available for everyone in Apple TestFlight. You do not need an invitation or an activation code.

Please note: You only need to log in with your test user, not register.

  1. Open the TestFlight link on your iOS phone (it will not work on macOS, and you cannot search for Vipps in TestFlight)
  2. Install the "Vipps MT" app
  3. Open the "Vipps MT" app
  4. Enter the test phone number, that was sent in the welcome email to the email address used in the registration (please double check before asking for a new test phone number). Your normal Vipps user is not available in the test environment.
  5. On the "Verify your number" screen: Use PIN 1236.
  6. On the "Enter your code" screen: Use PIN 1236.
  7. Enable FaceID (or TouchID) and confirm with PIN 1236.
  8. Accept push notifications.

You are now ready to use the iOS test app connected to the Vipps test environment.

Install Vipps MT on Android

The Android test app is available for everyone in App Center. You do not need an invitation or an activation code.

Please note: You only need to log in with your test user, not register.

  1. Open the App Center link on your Android phone (it will not work on a PC/Mac). If you get a push message prompting to whitelist the source, you should be able to do this via the "Settings" button.
  2. Install the "Vipps Android" app
  3. Open the "Vipps Android" app
  4. Enter the test phone number, that was sent in the welcome email to the email address used in the registration (please double check before asking for a new test phone number). Your normal Vipps user is not available in the test environment.
  5. On the "Verify your number" screen: Use PIN 1236.
  6. On the "Enter your code" screen: Use PIN 1236.
  7. Enable touch id and confirm with PIN 1236.
  8. Accept push notifications.

You are now ready to use the Android test app connected to the Vipps test environment.

Other versions

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.

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

Limitations of the test apps

Push alerts may be unstable. To see payment requests: Open Vipps and manually go to "Betalinger" (i.e., Payments) at the bottom of the main screen. You may also need to pull down to refresh.