Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
193 lines (136 sloc) 8.25 KB

Vipps Developers

This repository contains various resources for Vipps developers, including:

Table of contents

Postman

Postman is a common tool for working with REST APIs. We offer Postman Collections for some APIs. Postman can import Swagger files directly, so collections are not a requirement.

With Postman you can make calls to all the API endpoints and see the full request and response for each call, including headers.

When contacting us about API issues, we are usually able to help faster if you send us the complete request and response.

See our Postman guide or the Postman documentation for more information about using Postman.

Our Postman collections and environments

Product Github Link
eCommerce V2 https://github.com/vippsas/vipps-ecom-api/tree/master/tools
Invoice https://github.com/vippsas/vipps-invoice-api/tree/master/tools
Recurring https://github.com/vippsas/vipps-recurring-api/tree/master/tools

Example code

We have made some example code available, in hope that it may be useful: https://github.com/vippsas/vipps-developers/tree/master/code-examples

The Vipps test environment (MT)

The Merchant Test Environment (MT) is available for all Vipps customers.

The 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, such as Payment Service Providers, EVRY, Nets, banks, etc.

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

  • Push alerts may be unstable
  • Payment of invoices, both for Vipps Regninger and Vipps Faktura
  • Limited support for testing card statuses that require connections to Nets, etc
  • Limited support for looking up customer information in KAR, etc

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 in MT:

  • We allow 10,000 incorrect PIN attempts before locking the Vipps user's account

Test users

The welcome email contains information about your test user, which has the following dummy data:

  • Name
  • Phone number
  • PIN
  • Bank account number
  • Credit card number

You can use this test user to in the Vipps test apps.

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

If you need additional payment cards, you can add it in the Vipps app. See Credit card numbers for more details.

See also: Vipps Test Data.

Vipps test apps

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

Only test accounts, with random phone numbers, are available in the test environments. Normal Vipps users are not available, so you can not use your own phone number with the test apps.

Limitations of the test apps

  • Push alerts do not work
  • For iOS: There may be conflicts with the production apps, and we recommend to only have one of the apps installed

iOS

Vipps test app icon

The iOS test app is available in Apple TestFlight: https://testflight.apple.com/join/hTAYrwea You do not need an activation code.

  1. Open the TestFlight link
  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. 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.

Please note: App-switching on iOS uses the same URL pattern for both the production Vipps app (in App Store) and the MT test app (in TestFlight). This means that iOS may open either of the apps for a vipps:// URL, as iOS can not know which of the apps to open. Because of this, we recommend to only have one of the apps installed on the same device.

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

Android

The Android test app is available at: https://install.appcenter.ms/orgs/vipps/apps/vipps-android/distribution_groups/mt%20testers You do not need an activation code.

  1. Open the App Center link. 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. 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.

Please note: Older versions of the test app using a mobile browser for the landing page will not work in the test environment. This is because it will always redirect to the production Vipps app, not the MT test app. If the production Vipps app is not installed, the redirect will open Google Play to download the production Vipps app.

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

Vipps design guidelines

Guidelines, logos, buttons, etc: https://github.com/vippsas/vipps-design-guidelines

Vipps request servers

Requests made by Vipps are made from the following servers:

Production environment:

callback-1.vipps.no
callback-2.vipps.no
callback-3.vipps.no
callback-4.vipps.no

Test environment:

callback-mt-1.vipps.no
callback-mt-2.vipps.no
callback-mt-3.vipps.no
callback-mt-4.vipps.no

For products that Vipps makes requests please make sure that requests from these servers are allowed through firewalls, etc.

Note: Vipps may change the IP addresses that we make requests from. To ensure that you are whitelisting the corrects IP addresses please use these hostnames.

Additional developer resources

The Vipps Integration team
Get in touch here

You can’t perform that action at this time.