About VIPPS

General information about VIPPS

Page properties

Logo

Info

Excerpt

Vipps is a mobile wallet enabling quick and secure payments in Norway, Denmark and Finland, where it operates as MobilePay. Users can link their phone numbers to payment cards for peer-to-peer transfers, bill payments and online or in-store purchases. It also simplifies shared expense management, like splitting group costs. It is widely adopted across Scandinavia, offering seamless digital payment experiences for consumers and merchants alike.

Type

Payments by eWallet

A mobile payment solution enables customers to complete transactions using their phone number. This system integrates both Vipps and MobilePay through a unified API. The process involves steps such as authorization, token generation, and redirection. The unified API is designed for use in Sweden and Finland under the MobilePay brand and in Norway under the Vipps brand. Customers receive a request on their mobile app and confirm the transaction directly on their smartphone. This solution streamlines payments by securely storing card details in the app, eliminating the need for manual card entry. It also supports invoice receipt. The design guidelinke could be found on following link: https://developer.vippsmobilepay.com/docs/knowledge-base/design-guidelines/buttons/

Further information can be found on the webpage of VIPPS (https://vippsmobilepay.com/en).

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Definition
PageWithExcerpt	Definition EN

Payment with VIPPS over form interface

To initiate a payment with VIPPS, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

vipps.aspx

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1656494139922_-797360181
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	vipps_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1656494139924_1618588093
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Key	Format	CND	Description

Beschreibung

RefNr

an..50

O

Unique identifier for the payment. Must be unique for the sales unit. It should be UUID preferably, without leading zero, A-Z/a-z, hyphen '-'. New reference ID should be provided for each attempt.

Eindeutige Kennung für die Zahlung.Muss für die Verkaufseinheit eindeutig sein.Es sollte vorzugsweise eine UUID ohne führende Null sein, A-Z/a-z, Bindestrich '-'.Für jeden Versuch muss eine neue Referenz-ID angegeben werden.

Amount

n..10

Amount

n..10

M	Amount in the smallest currency unit. Minimum amounts: NOK: 100 øre, DKK: 1 øre, EUR: 1 cent

Betrag in der kleinsten Währungseinheit.Mindestbeträge: NOK: 100 øre, DKK: 1 øre, EUR: 1 Cent


Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. NOK, EUR, DKK. Please find an overview here: A1 Currency table

Währung, drei Zeichen DIN / ISO 4217, z.B. NOK, EUR, DKK. Hier eine Übersicht: A1 Währungstabelle

Table Excerpt IncludestatictruenameMAC

Table Excerpt Include

static	true
name	MAC

page	MAC
type	page

Key	Format	CND	Description

Beschreibung

OrderDesc

ans..100

M

Description of purchased goods

Beschreibung der gekauften Waren

Table Excerpt Include

static	true
name	URLSuccess
page	URLSuccess
type	page

Table Excerpt Include

static	true
name	URLFailure
page	URLFailure
type	page

Table Excerpt Include

static	true
name	Response
page	Response
type	page

Table Excerpt Include

static	true
name	URLNotify
page	URLNotify
type	page

Key	Format	CND	Description

Beschreibung


MinAge	n..2	O	Minimum age required for purchase. If specified, VIPPS will verify customer's age before allowing payment. Valid values: 15-99

Erforderliches Mindestalter für den Kauf.Falls angegeben, überprüft VIPPS das Alter des Kunden, bevor die Zahlung akzeptiert wird.Gültige Werte: 15–99


phoneNumber	an..15	O	Customer's phone number in MSISDN format (e.g., 4712345678). Recommended to provide for better user experience – allows pre-filling phone number on VIPPS payment page.

Telefonnummer des Kunden im MSISDN-Format (z. B. 4712345678).Empfohlen für eine bessere Benutzererfahrung – ermöglicht das Vorabfüllen der Telefonnummer auf der VIPPS-Zahlungsseite. Table Excerpt IncludestatictruenamePlain

Table Excerpt Include

static	true
name	Plain

page	Plain
type	page

Table Excerpt Include

static	true
name	Custom
page	Custom
type	page

Parameters for VIPPS

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_IntroURL
PageWithExcerpt	Reuse API

filterdefaultisFirstTimeEnterhideColumnstruesparkName1656494439379177717264ANDPoint ()

Multiexcerpt

MultiExcerptName	vipps_response

table-

joiner

dateFormat

Beschreibung

export-word
dd M yy

	false

show-source

false

hidePane

true

datepattern

dd M yy

export-csv

Sparkline

false

id

1656494439381_-

424410213
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m

isOR

separator

.

export-

order

0

export-

Multiexcerpt

MultiExcerptName	vipps_response

Table Transformer

dateFormat

dd M yy

export-word

false

show-source

false

export-csv

false

id

1656494439381_-424410213

transpose

false

worklog

365|5|8|y w d h m|y w d h m

separator

.

pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MID
page	mid
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	XID
page	XID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Status_OK_AUTHORIZE_REQUEST
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Table Excerpt Include

static	true
name	Plain
page	Plain
type	page

Table Excerpt Include

static	true
name	Custom
page	Custom
type	page

Result parameters for URLNotify, URLSuccess and URLFailure in case of VIPPS

Create agreement for VIPPS recurring payments (RTF=A or RTF=I)

In order to create an agreement for VIPPS recurring payments with or without initial charge, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

vipps.aspx

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

filter

Multiexcerpt

MultiExcerptName	vipps_request_create_agreement

table-

joiner

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1761734588565_-1479870066
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	vipps_request_create_agreement

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1761734588567_1336843480
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Table Excerpt Include

static	true
name	URLSuccess
page	URLSuccess
type	page

Table Excerpt Include

static	true
name	URLFailure
page	URLFailure
type	page

Table Excerpt Include

static	true
name	Response
page	Response
type	page

Table Excerpt Include

static	true
name	URLNotify
page	URLNotify
type	page

Table Excerpt Include

static	true
name	Plain
page	Plain
type	page

Table Excerpt Include

static	true
name	Custom
page	Custom
type	page

Key	Format	CND	Description

Beschreibung

ProductName

RTF

a1

C

A = Create agreement without initial charge / I = Create agreement with initial charge

A = Vereinbarung ohne initiale Zahlung einrichten / I = Vereinbarung mit initialer Zahlung einrichten

ProductName

ans..45

M

Product name displayed to customer

Dem Kunden angezeigter Produktname

OrderDesc

ans..100

M

Description of purchased goods/products

Beschreibung der gekauften Waren/Produkte

PricingType

ans..8

M

For LEGACY = Fixed recurring amount / For VARIABLE = Flexible amount per charge

Für LEGACY = Fester, wiederkehrender Betrag / Für VARIABLE = Flexibler Betrag pro Zahlung


Amount	n..10	C	For LEGACY: Mandatory - fixed recurring amount in smallest currency unit / For VARIABLE:

Optional

Mandatory - suggested maximum amount

, or use Amount=0 for no suggestion

Für LEGACY: Obligatorisch – fester, wiederkehrender Betrag in der kleinsten Währungseinheit / Für VARIABLE: Optional – empfohlener Höchstbetrag oder Betrag=0 für keine Empfehlung

that customer can approve. Minimum amounts apply: NOK 100 øre, DKK 1 øre, EUR 1 cent.
Currency	a3	M	Currency, three digits

Currency

a3

M

Currency, three digits

DIN / ISO 4217, e.g. NOK, EUR, DKK. Please find an overview here: A1 Currency table

Währung, drei Zeichen DIN / ISO 4217, z.B. NOK, EUR, DKK. Hier eine Übersicht: A1 Währungstabelle


AgreementInterval	ans..5	O	Interval unit: YEAR, MONTH, WEEK, DAY. If not provided, creates variable agreement without fixed interval

Intervalleinheit: YEAR, MONTH, WEEK, DAY.Falls nicht angegeben, wird eine variable Vereinbarung ohne festes Intervall erstellt.

AgreementIntervalCount

n..2

O

Number of units in time period (e.g., unit=WEEK, count=2 for bi-weekly)

Anzahl der Einheiten im Zeitraum (z. B. Einheit = WEEK, Anzahl = 2 für zweiwöchentlich)

URLConfirm


URLConfirm	ans..

ans..

256

M

URL where customer is redirected after agreement approval/rejection in VIPPS app

URL, zu der der Kunde nach Genehmigung/Ablehnung der Vereinbarung in der VIPPS-App weitergeleitet wird

VippsMerchantAgreementURL

TermURL

ans..1024

C

URL where customer can manage subscription. Mandatory for Norway. Must offer actual management capabilities, not just contact info

.URL, über die Kunden ihr Abonnement verwalten können

.

Für Norwegen Pflicht.Die URL muss tatsächliche Verwaltungsfunktionen bieten und nicht nur Kontaktinformationen.

MinAge

n..2

O


phoneNumber	an..15	O	Customer's phone number in MSISDN format (e.g., 4712345678) for pre-filling. Accepts 0-15 digits. If 10-15 digits provided, sent to VIPPS for pre-filling. If less than 10 digits or empty, omitted from request but payment proceeds normally. Customer enters phone manually on VIPPS page when not provided.

Die Telefonnummer des Kunden im MSISDN-Format (z. B. 4712345678) zum Vorausfüllen.Akzeptiert werden 0–15 Ziffern.Bei 10-15 Ziffern wird die Nummer zum Vorausfüllen an VIPPS gesendet.Bei weniger als 10 Ziffern oder wenn das Feld leer ist, wird sie aus der Anfrage entfernt, die Zahlung erfolgt jedoch normal.Falls die Telefonnummer nicht angegeben wurde, gibt der Kunde sie manuell auf der VIPPS-Seite ein.


MinAge	n..2	O

Minimum age required (15-99). VIPPS verifies before allowing payment.

Erforderliches Mindestalter (15-99 Jahre).VIPPS überprüft das, bevor die Zahlung freigegeben wird.

AboID

ans..64

AboID

ans..64

O

External subscription ID to map agreement to merchant's system

Externe Abonnement-ID für die Zuordnung der Vereinbarung zum System des Händlers

RefNr

an..50

O

Unique identifier for payment

(UUID preferred, A-Z/a-z, hyphen allowed)

Eindeutige Kennung für die Zahlung (UUID bevorzugt, A-Z/a-z, Bindestriche erlaubt)

ChargeAmount

n..10

M

Only for RTF=I: Initial charge amount in smallest currency unit (e.g. 1000 = 10.00 NOK)

Amount (or leave empty/0) = defines the recurring pricing for FUTURE charges
ChargeAmount = defines the actual amount charged IMMEDIATELY upon agreement approval
These can be different (e.g. discounted first payment, then regular price)

Example – Monthly subscription with first month discount:

Code Block
RTF=I PricingType=LEGACY Amount=1000 // Regular monthly price for future charges ChargeAmount=500 // Discounted first month charge ChargeDescription=First month special offer

Nur für RTF=I: Anfangszahlung in der kleinsten Währungseinheit (z. B. 1000 = 10,00 NOK)

Amount (oder leer lassen/0) = definiert die wiederkehrenden Preise für ZUKÜNFTIGE Zahlungen
ChargeAmount = definiert den tatsächlich berechneten Betrag, der SOFORT nach Vertragsabschluss fällig wird
Diese Beträge können unterschiedlich sein (z. B. erste Zahlung mit Rabatt, danach regulärer Preis)

(UUID preferred, A-Z/a-z, hyphen allowed)
ChargeAmount	n..10	M	Only for RTF=I: Initial charge amount in smallest currency unit (e.g. 1000 = 10.00 NOK) Amount (or leave empty/0) = defines the recurring pricing for FUTURE charges ChargeAmount = defines the actual amount charged IMMEDIATELY upon agreement approval These can be different (e.g. discounted first payment, then regular price) Example – Monthly subscription with first month discount

Beispiel – Monatsabonnement mit Rabatt im ersten Monat

:

Code Block
RTF=I PricingType=LEGACY Amount=1000 // Regular monthly price for future charges ChargeAmount=500 // Discounted first month charge ChargeDescription=First month special offer

ChargeDescription

ans..100

M

Only for RTF=I: Description for the initial charge (visible to customer

)Nur für RTF=I: Beschreibung für die Erstzahlung (für den Kunden sichtbar

			Campaign parameters
)

(optional)Kampagnenparameter

(optional)
CampaignType	ans..13	O	PRICECAMPAIGN = Special price until end date / PERIODCAMPAIGN = Special price for defined intervals / EVENTCAMPAIGN = Special price until event date

PRICECAMPAIGN = Sonderpreis bis zum Enddatum /

PERIODCAMPAIGN = Sonderpreis für festgelegte Zeiträume /
EVENTCAMPAIGN = Sonderpreis bis zum Veranstaltungsdatum

CampaignPrice

n..10

C

Campaign price in smallest currency unit. Required if CampaignType specified

.Kampagnenpreis in der kleinsten Währungseinheit.Erforderlich, wenn CampaignType angegeben ist

.
CampaignEnd	dttm	C	Required for PRICECAMPAIGN: Campaign end date

(ISO 8601)Erforderlich für PRICECAMPAIGN: Kampagnenenddatum

(ISO 8601)
CampaignIntervalUnit	ans..5	C	Required for PERIODCAMPAIGN: Unit for period: YEAR, MONTH, WEEK, DAY

Erforderlich für PERIODCAMPAIGN: Einheit für den Zeitraum: YEAR, MONTH, WEEK, DAY

CampaignIntervalCount

n..2

C

Required for PERIODCAMPAIGN: Number of units (1-31)

Erforderlich für PERIODCAMPAIGN: Anzahl der Einheiten (1-31)

CampaignEventDate

dttm

C

Required for EVENTCAMPAIGN: Event date (ISO 8601)

Required for EVENTCAMPAIGN: Event date

Erforderlich für EVENTCAMPAIGN: Veranstaltungsdatum

(ISO 8601)
CampaignEventText	ans..100	C	Required for EVENTCAMPAIGN: Event description

Erforderlich für EVENTCAMPAIGN: Veranstaltungsbeschreibung

Parameters for creating an agreement for VIPPS recurring payments

Space shortcuts

Page tree

Versions Compared

Old Version 40

New Version Current

Key

About VIPPS

General information about VIPPS

On this page

Process flow chart

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface

Payment with VIPPS over form interface

Create agreement for VIPPS recurring payments (RTF=A or RTF=I)

Create recurring payment (RTF=R) for VIPPS

Cancel/Terminate agreement (RTF=C) for VIPPS recurring payments

Important notes for recurring payments

Phone number parameter

Agreement management

Charge processing

Pricing models

Campaign support

User-initiated cancellations

Examples

Example 1: Create agreement without initial charge

Example 2: Create agreement with discounted initial charge

Example 3: Create recurring charge

Example 4: Terminate agreement

Capture

Credit with reference

Reversal

Paygate

Computop

Help

Intranet Tools


BillingAgreementID	ans..64	M	Agreement identifier to charge against (from agreement creation response

)
DueDate	a10	M	When charge should be processed (YYYY-MM-DD format). Must be at least 2 days in advance

(production) or 1 day (test environment).
AboID	ans..64	O	External subscription ID

Space shortcuts

Page tree

Page History

Versions Compared

Old Version 40

New Version Current

Key

About VIPPS

General information about VIPPS

On this page

Process flow chart

Multiexcerpt includeSpaceWithExcerptENMultiExcerptNamePlatform-KurzPageWithExcerptWording interface

Payment with VIPPS over form interface

Create agreement for VIPPS recurring payments (RTF=A or RTF=I)

Create recurring payment (RTF=R) for VIPPS

Cancel/Terminate agreement (RTF=C) for VIPPS recurring payments

Important notes for recurring payments

Phone number parameter

Agreement management

Charge processing

Pricing models

Campaign support

User-initiated cancellations

Examples

Example 1: Create agreement without initial charge

Example 2: Create agreement with discounted initial charge

Example 3: Create recurring charge

Example 4: Terminate agreement

Capture

Credit with reference

Reversal

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface