Skip to main content

Terminology

Common terms​

  • API keys - Codes that provide a merchant with access to the API (e.g., client_id, client_secret, Ocp-Apim-Subscription-Key). Think of them as "username and password". Keep them secret. See How to find the API keys.

  • client_id - The client ID (e.g., the "username") for the merchant. Keep it secret. See How to find the API keys.

  • client_secret - The client secret (e.g., "password") for the merchant. Keep it secret. See How to find the API keys.

  • Deeplink - The "deeplink" opens the payment page in the app, where the user accepts a payment. This is an integrated part of the payment process, and the link should never be sent in an SMS or email.

  • Direct capture - Direct capture causes all payment reservations to be instantly captured. This is intended for situations where the product or service is immediately provided to the customer, e.g. digital services.

  • Idempotency-Key - An idempotency header ensures that, if the merchant retries a request with the same idempotency key, the retried request will not make additional changes. See the API specification for the requirements for the idempotency key.

  • Merchant - A juridical unit, typically called a business, identified with organization number (orgno).

  • Merchant Serial Number (MSN) - The MSN identifies a sales unit (not a merchant). We recommend that everyone sends this header so that we can help you debug errors, if the need arises. Partners must always send the Merchant-Serial-Number header, even when using the merchant's API keys.

    The MSN is defined with the sales unit is created. See How to find the MSN.

  • National identity number (NIN) - A number that uniquely identifies a citizen in a country. Merchants need to apply for access to the NIN. See Who can get access to NIN and how?.

  • Ocp-Apim-Subscription-Key - This is the subscription key for the sales unit. Keep it secret. We will never ask for it, and we don't need it for anything. See how to find the API keys.

  • orderId - The API parameter that supplies a unique identifier for the payment. This is the same as reference. Newer APIs will use reference instead of orderId. See the API specification for the requirements for this ID.

  • Partner - A partner is a business that represents several merchants by providing a platform, helping set up custom integrations, or developing our official plugins. See: Partners.

  • Partner keys - Unique identifiers that allow partners to use their own API credentials to make API calls on behalf of their merchants. See: Partner keys.

  • Payment Service Provider (PSP) - A third-party business that performs online payments on behalf of Vipps MobilePay. Settlements for PSP integrations are handled by the PSP.

  • Point of Sale (POS) - A POS is a physical store. It's a type of sales unit.

  • reference - The API parameter that supplies a unique identifier for the payment. This is the same as orderId. Newer APIs will use the name reference instead of orderId.

  • Reserve capture - Reserve capture is the normal flow. When the end user approves an initiated payment, it will be marked as reserved by the bank, but not transferred. It will stay reserved until the point at which it is captured.

  • Sales unit - A sales unit is anything that can sell goods or services and offer payment through Vipps or MobilePay. A merchant can have one or more sales units (e.g., a physical store, an online store, and an app). A merchant might also use different sales units for their different physical locations, different services, different brands, etc.

Norwegian terms​

  • BankID - Software that certifies the identity of a person.

  • Brønnøysundregistrene - The Brønnøysund Register, or Business registry, is the official Norwegian register of companies.

  • D-nummer - A Norwegian identification number given to foreign persons who do not have a Norwegian national identity number (NIN), but have a need for identification for the Norwegian authorities.

  • Finanstilsynet - A Norwegian agency that supervises Norwegian financial companies.

  • Fødselsnummer - An 11-digit number that uniquely identifies each Norwegian citizen.

  • orgno - The organization number for a merchant. Nine digits. This can be used to retrieve information at Brønnøysundregistrene, the Norwegian business registry.

Danish terms​

  • MitID - Software that certifies the identity of a person.

  • Det Centrale Virksomhedsregister - The official Danish register of companies.

  • orgno - The organization number for a merchant. Also called CVR or VAT-number. 8 digits. This can be used to retrieve information at Det Centrale Virksomhedsregister.

  • Finanstilsynet - The Danish Financial Supervisory Authority that supervises Danish financial companies.

  • CPR-nummer - Social Security Number (SSN). A 10-digit number that uniquely identifies each Danish citizen. This is also called.

  • Administrative CPR-nummer - A Danish identification number given to foreign persons who do not have a Danish social security number (SSN), but have a need for identification for the Danish authorities.

Finnish terms​

  • Finnish Trust Network (FTN) - Software that certifies the identity of a person.

  • Yritys- ja yhteisötietojärjestelmä (YJT) - The official Finnish register of companies.

  • orgno - The business ID for a merchant. Also called Y-tunnus (Yritys- ja yhteisötunnus) or VAT-number. 8 digits. This can be used to retrieve information at YTJ.

  • Finanssivalvonta - Financial Supervisory Authority.

  • Henkilötunnus - Personal Identity Code. A sequence of 11 characters that uniquely identifies each Finnish citizen.

Help us improve our documentation

Did you find what you were looking for?