Skip to main content

Test environment

All partners and merchants with access to the APIs have access to the test environment. The test environment is available for Vipps Vipps and MobilePay MobilePay, with the limitations below.

To access the test environment, you need:

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 create a test user.

Create a test user

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

You can create and retrieve test users on portal.vippsmobilepay.com once you have an active customer relationship. For login instructions, see How to log in.

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

Portal test users

Important information about test users:

  • Test users can be used on multiple devices and networks simultaneously.
  • Test users are not linked to any specific merchant or partner. You can use them with any merchant and sales unit in the test environment.
  • Test user attributes (name, birthdate, etc.) are randomly generated when created. You can specify a birthdate if needed.
  • You cannot request a test user with specific attributes (other than age) since attributes are randomly generated.
  • You cannot modify an existing test user.
  • Test users are not available in the production environment. Production only contains real users and data.
note

Test merchants and test users are not available in production. To test in production, you must onboard as a merchant and order a product. This requires completing mandatory compliance checks and making real transactions with an actual user using the production app. We recommend performing as much testing as possible in the test environment.

Test user properties

You can find test user information on portal.vippsmobilepay.com.

  1. Go to portal.vippsmobilepay.com and select For developers from the sidebar. (If you don't see this option, ask your Administrator to grant you Developer access.)
  2. Select the Test users tab.
  3. Select the test user to view its information.

National identity number

A fictitious National Identity Number (NIN) is randomly generated when you create a test user.

You need the NIN to log in to the test app.

Phone number

A phone number is assigned when you create a test user. You need this for logging in to the test app.

Never use test phone numbers in the production environment—they could belong to real users.

Email address

You can add a real email address to a test user by navigating to Profile select menu Personal information select menu Email in the test 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.

Note that simply updating and saving the email will not trigger a verification email. You can ignore the unverified status indicator on the profile page.

Payment card

Each test user comes pre-registered with a payment card. You cannot add new cards in the test app.

Test sales units

note

Sales units in the production environment are subject to strict regulatory and other requirements. As a result, you may not be able to replicate the sales unit configuration there, even though you have it in the test environment.

All merchants with API access can use the test environment (with some exceptions).

A test sales unit is automatically created when you order a Vipps MobilePay product that includes an API. You can find the details and API keys in the Developer section on portal.vippsmobilepay.com. For login instructions, see the portal guide.

Test sales units inherit the country code of the merchant they're created for:

  • Norwegian merchants can only create Norwegian sales units
  • Danish merchants can only create Danish sales units
  • Finnish merchants can only create Finnish sales units

Test sales units cannot be modified after creation, but you can create as many test sales units as needed.

See: How to create a test sales unit.

Test apps

The test apps for iOS and Android closely mirror the production apps. They connect to the Merchant Test (MT) environment instead of production, allowing you to test the complete payment flow with API requests using test users.

You can install the test app alongside the production app on the same device without conflicts, as the test app uses the vippsMT:// URL scheme, while the production app uses vipps://.

note

Only test users with randomly generated phone numbers are available in the test environment. You cannot use your own phone number or real user accounts with the test apps. Never use test phone numbers in the production environment—they may belong to real people.

App installation

Vipps MobilePay requires a minimum version of the phone's operating system. For the exact requirements, please visit help.vippsmobilepay.com.

The iOS test app is available through Apple TestFlight.

No invitation or activation code is required.
If TestFlight prompts for one, close and reopen the app using the link below.

  • On your iOS phone, open the TestFlight link.
    Note: This link will not work on macOS, and TestFlight search is not helpful.

    QR code for quick access:

Steps within the MT app:

After installing the app, follow these steps to set up your test user:

  1. Select your country—it must match your test user's country or registration will fail.
  2. If prompted for an age check, select Over 15.
  3. Locate and copy your test user's phone number and NIN (see Test user properties).
  4. Enter your test user's NIN.
  5. Enter your test user's phone number.
    Note: Your normal Vipps Vipps or MobilePay MobilePay credentials will not work in the test environment.
  6. Enter 1236 to confirm your phone number.
    You can enter up to 10,000 incorrect PIN attempts before the account locks.
  7. Click Next to confirm your identity.
    A temporary browser window will open and close—this simulates production eID verification. You can ignore it.
  8. Enter 1236 to create a personal code.
  9. Re-enter 1236 to confirm the personal code.
  10. Enable biometrics (optional).
  11. Allow notifications.

For issues with the MT app, contact developer@vippsmobilepay.com.

Using other versions of the app

In some cases, you may need to use specific app versions in MT. This can occur when the production apps and the production environment are not fully aligned with the test environment. When this happens, we provide details on the test environment status page.

Using an emulator

If you use an emulator instead of the native app on a physical device, you may experience issues, including having to log in from scratch every time you launch the app in the emulator.

API keys

API keys are linked to a specific test sales unit and can only be used with that unit.

The test and production environments are completely separate, so you need different API keys for each environment.

Test environment API keys are typically available within a few minutes after creating a test sales unit.

See:

Test server

Test (MT) API server:

https://apitest.vipps.no

Production API server:

https://api.vipps.no

  • Test and production environments are completely separate—each requires its own API credentials.
  • Both servers are accessible worldwide with no IP restrictions on the Vipps MobilePay side.
  • Access control relies solely on valid API keys.

See Servers for more information.

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 in minor units (øre, cents)Error
151Insufficient funds
182Refused by issuer
183Suspected fraud
184Withdrawal limit exceeded
186Expired card
187Invalid card
1973D Secure denied (only applicable in Norway)
201Unknown result for 1 hour
202SCA required (only applicable in Norway)

Refund test amounts

Amount in minor units (øre, cents)Error
123Cannot refund single transferred payments (this error indicates that the user is deleted or does not have a receiving account)
124Refund period expired

MobilePay facade test

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

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:

  • The test app still looks like Vipps Vipps, but the APIs and flows are the same and can be fully tested for MobilePay MobilePay markets.
  • 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.
  • The activity list is empty and old payments cannot be found.
  • Partner functionality and the use of partner keys is not available. Partners will receive merchant keys for test.
  • The following APIs are not available in the test environment:
  • 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.
  • There is no equivalent to portal.vippsmobilepay.com for the test environment.
  • The user's email address can't be verified in the normal way. See: Email address.
  • Contactless payments (tap to pay, NFC) are not supported.
  • Gender is not available through Profile sharing in the ePayment API or Login.

To test functionality not available in MT, use the production environment in a controlled manner with a real user and real merchant.