Skip to main content

Vipps Partner API (1.2.1)

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, so the merchant can review the information and submit the product order on portal.vipps.no. Please note complianceData and website information are required for VIPPS_PA_NETT product type. Partners can still submit the product orders without them but the merchant will have to fill website and compliance data information manually in the merchant portal product order form and submit.

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.

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 Vipps app or Vipps landing page.

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.

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

The bank account number belonging to the organisation that will be used for settlement.

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

(deprecated) Optional. 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>

Optional. Currently only valid for 'VIPPS_PA_NETT'. 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 a new uuid, 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.

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

The type of product ordered for the merchant

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

object or null
object or null

Responses

Request samples

Content type
application/json
{
  • "orgno": "987654321",
  • "salesUnitName": "ACME Fantastic Fitness",
  • "salesUnitLogo": "VGhlIGltYWdlIGdvZXMgaGVyZQ==",
  • "settlementAccountNumber": "86011117947",
  • "pricePackageKey": "posstandard",
  • "productType": "VIPPS_PA_NETT",
  • "annualTurnover": 100000,
  • "intendedPurpose": "Gym membership",
  • "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 sale 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 sale 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": {
    }
}