Skip to main content

Vipps Partner API (1.3.4)

Download OpenAPI specification:Download

The Vipps Partner API lets partners, banks and large corporations manage their merchants (for example, submit product orders on behalf of their merchants) and sales units. See the API Guide for more information.

Vipps Product Orders

Submit product orders on behalf of their merchants

Order products on behalf of merchants

Order products on behalf of merchants: Partners can submit data that pre-fills the order form on portal.vipps.no, so the merchant can review the information and submit the product order.

Please note complianceData and website information are required for the VIPPS_PA_NETT product type. Partners can still submit the product orders without it, but the merchant will have to fill website and compliance data information manually in the merchant portal product order form and submit.

We have made as many of the fields as possible optional, but please try to send as much as you can, to make it easy for the merchant.

IMPORTANT: Please provide all the necessary details, so it will not be necessary for merchants to request more details. This is the most common reason for delays.

Authorizations:
Bearer-Authorization
header Parameters
Ocp-Apim-Subscription-Key
required
string
Example: da7d5b0e18a84aeda961c0c31b75c2a9

Vipps Subscription Key

Idempotency-Key
required
string
Example: 81b83246-5c19-7b94-875b-ea6d1114f099

Idempotency key for the request, ensures idempotent actions. Not required, but recommended.

Request Body schema: application/json

Product order for a merchant request body

orgno
required
string = 9 characters ^[0-9]{9,9}$

Organisation number of the merchant for whom the partner is submitting the product order. Only Norwegian organization numbers are allowed (for now).

salesUnitName
string or null [ 1 .. 30 ] characters ^[\p{L}\p{M}\d\\(\)-_\+\s\.]+$

The name of the point of sale that will be shown to the users in the Vipps app and on the Vipps landing page. The sales unit name can be edited later on portal.vipps.no.

salesUnitLogo
string or null <byte>

Base64 encoded string of the logo of the merchant. The logo will be displayed in the Vipps app, both when paying and on receipts and also in Vipps landing page. The logo must be in PNG (Portable Network Graphics) format. Square images are recommended. The longest side can not be more than 1000 pixels. The minimum size is 100 x 100 pixels. Images not matching the above criteria will not be shown to the merchant in the merchant portal. The logo can be edited later on portal.vipps.no.

settlementAccountNumber
string or null = 11 characters ^[0-9]{11,11}$

The bank account number belonging to the organisation that will be used for settlement. The bank account must be owned by the merchant. BBAN (not IBAN) format.

pricePackageKey
string or null [ 1 .. 255 ] characters ^[a-zA-Z0-9-]{1,15}$
Deprecated

Deprecated. One of the price packages that are registered for the partner in the Vipps system. Please note, it is not the PriceId (3 digit), but the name, such as "standard", "price1", etc, that is applicable to the partner. If the field is not provided, the merchant must select it manually from the product order section of the merchant portal before submitting.

pricePackageId
string or null <uuid>

Only for productType: VIPPS_PA_NETT and VIPPS_I_KASSA. The id for one of the price packages that are registered for the partner in the Vipps system. Please note: This is a UUID, not the 3-digit key. If this field is not provided, the merchant must select the price manually.

productType
required
string
Enum: "VIPPS_PA_NETT" "VIPPS_LOGG_INN" "VIPPS_CHECKOUT" "VIPPS_I_KASSA"

The type of product ordered for the merchant.

productUseCase
string or null
Default: "Website"
Enum: "Website" "WebsiteWithTest" "App" "Unknown"

Where will sales take place? A website? A website that is not yet launched, so a test website must be used? A native app? Something else?

annualTurnover
integer <int64> [ 0 .. 9223372036854776000 ]

Annual turnover for the merchant in NOK (without øre).

intendedPurpose
string or null

Description of the product or products that will be sold. Please include all information relevant to processing the product order, such as including "POS integration" to indicate that the sales unit needs skipLandingPage.

object or null
object or null

Responses

Request samples

Content type
application/json
{
  • "orgno": "987654321",
  • "salesUnitName": "ACME Fantastic Fitness",
  • "salesUnitLogo": "VGhlIGltYWdlIGdvZXMgaGVyZQ==",
  • "settlementAccountNumber": "86011117947",
  • "pricePackageId": "8a11afb7-c223-48ed-8ca6-4722b97261aa",
  • "productType": "VIPPS_PA_NETT",
  • "annualTurnover": 100000,
  • "intendedPurpose": "Gym membership for accessing the gym's facilities.\nGuest will be not physically present when buying the subscription,\nas that is done on the gym's website.",
  • "website": {},
  • "complianceData": {
    }
}

Response samples

Content type
application/json
{}

Merchants

Manage merchants

Get merchant by organization number

Authorizations:
Bearer-Authorization
path Parameters
orgno
required
string = 9 characters ^\d{9}$
Example: 987654321

The organization number for the merchant

header Parameters
Ocp-Apim-Subscription-Key
required
string
Example: da7d5b0e18a84aeda961c0c31b75c2a9

Vipps Subscription Key

Responses

Response samples

Content type
application/json;charset=UTF-8
{
  • "msn": [
    ]
}

Sales units

Manage sales units

Get sales unit details based on MSN

Authorizations:
Bearer-Authorization
path Parameters
msn
required
string [ 5 .. 6 ] characters ^\d{5,6}$

The Vipps MSN (merchant serial number) for the sales unit.

header Parameters
Ocp-Apim-Subscription-Key
required
string
Example: da7d5b0e18a84aeda961c0c31b75c2a9

Vipps Subscription Key

Responses

Response samples

Content type
application/json;charset=UTF-8
{
  • "msn": "123456",
  • "name": "ACME Fantastic Fitness",
  • "orgno": 987654321,
  • "additionalDetails": {
    }
}