Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DEWORK and version Dokumentation

Über VIPPS

Allgemeines zu VIPPS

Page properties
Logo

Info
Excerpt

Vipps ist eine mobile Geldbörse, die schnelle und sichere Zahlungen in Norwegen, Dänemark und Finnland ermöglicht und dort unter dem Namen MobilePay betrieben wird.Nutzer können ihre Telefonnummern mit Zahlungskarten verknüpfen, um Peer-to-Peer-Überweisungen, Rechnungszahlungen sowie Online- und Ladeneinkäufe zu tätigen.Vipps vereinfacht auch die Verwaltung gemeinsamer Ausgaben, etwa die Aufteilung von Gruppenkosten.Vipps ist in Skandinavien weit verbreitet und bietet Verbrauchern und Händlern gleichermaßen nahtlose digitale Zahlungserlebnisse.

TypZahlungen per eWallet

Eine mobile Zahlungslösung ermöglicht es Kunden, Transaktionen über ihre Telefonnummer abzuschließen.Dieses System integriert sowohl Vipps als auch MobilePay über eine einheitliche API.Der Prozess umfasst Schritte wie Autorisierung, Token-Generierung und Weitereitung.Die einheitliche API ist für die Verwendung in Schweden und Finnland unter der Marke MobilePay und in Norwegen unter der Marke Vipps vorgesehen.Kunden erhalten eine Anfrage über ihre mobile App und bestätigen die Transaktion direkt auf ihrem Smartphone.Diese Lösung vereinfacht Zahlungen, indem Kartendetails sicher in der App gespeichert werden, sodass die manuelle Karteneingabe nicht mehr erforderlich ist.Sie unterstützt auch den Rechnungsempfang.Die Designrichtlinien finden Sie unter folgendem Linkhttps://developer.vippsmobilepay.com/docs/knowledge-base/design-guidelines/buttons/

Weitere Informationen finden Sie auch auf der Webseite von VIPPS (https://vippsmobilepay.com/en).

Auf dieser Seite

Table of Contents
exclude(Auf dieser Seite|In diesem Abschnitt|On this page|In this section).*


Diagramm zum Prozessablauf

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameProcessFlow
DisableCachingtrue
PageWithExcerptEN:VIPPS

Prozessablauf VIPPS


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording (veraltet)
-Schnittstelle

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameDefinition
PageWithExcerptDefinition DE


Zahlung mit VIPPS über Formular-Schnittstelle

Um eine Zahlung mit Vipps zu initialisieren, verwenden Sie bitte folgende URL:

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameBaseURL
PageWithExcerptWording (veraltet)
vipps.aspx

 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1772099280793_1855357184
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMerchantID
pageMerchantID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameTransID
pageTransID
typepage

Key

Format

CND

Beschreibung

RefNr

an..50

O

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

M

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

Currency

a3

M

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

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMAC
pageMAC
typepage

Key

Format

CND

Beschreibung

OrderDesc

ans..100

M

Beschreibung der gekauften Waren

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameURLSuccess
pageURLSuccess
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameURLFailure
pageURLFailure
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameResponse
pageResponse
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameURLNotify
pageURLNotify
typepage

Key

Format

CND

Beschreibung

MinAge

n..2

O

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

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 Include
isFirstTimeEntertrue
statictrue
v2
namePlain
pagePlain
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCustom
pageCustom
typepage

Parameter für VIPPS


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameResponse_IntroURL
PageWithExcerptReuse API

Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1772099294342_362929345
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMID
pagemid
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
namePayID
pagePayID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameXID
pageXID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameTransID
pageTransID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameStatus_OK_AUTHORIZE_REQUEST
pageStatus
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameDescription
pageDescription
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCode
pageCode
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
namePlain
pagePlain
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCustom
pageCustom
typepage

Ergebnis-Parameter für URLNotify, URLSuccess und URLFailure bei VIPPS


Vereinbarung einrichten für wiederkehrende Zahlungen mit VIPPS (RTF=A oder RTF=I)

Um eine Vereinbarung für wiederkehrende Zahlungen mit VIPPS mit oder ohne Erstzahlung einzurichten, verwenden Sie bitte folgende URL:

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameBaseURL
PageWithExcerptWording (veraltet)
vipps.aspx

 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1772099306235_1381877255
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMerchantID
pageMerchantID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameTransID
pageTransID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMAC
pageMAC
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameURLSuccess
pageURLSuccess
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameURLFailure
pageURLFailure
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameResponse
pageResponse
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameURLNotify
pageURLNotify
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
namePlain
pagePlain
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCustom
pageCustom
typepage

Key

Format

CND

Beschreibung

RTF

a1

C

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

ProductName

ans..45

M

Dem Kunden angezeigter Produktname

OrderDesc

ans..100

M

Beschreibung der gekauften Waren/Produkte

PricingType

ans..8

M

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

Amount

n..10

C

Für LEGACY: Obligatorisch – fester, wiederkehrender Betrag in der kleinsten Währungseinheit / Für VARIABLE: Obligatorisch – vorgeschlagener Höchstbetrag, den der Kunde genehmigen kann.Es gelten Mindestbeträge: 100 NOK øre, 1 DKK øre, 1 EUR Cent.

Currency

a3

M

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

AgreementInterval

ans..5

O

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

AgreementIntervalCount

n..2

O

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

URLConfirm

ans..256

M

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

TermURL

ans..1024

C

URL, über die Kunden ihr Abonnement verwalten können.Für Norwegen Pflicht.Die URL muss tatsächliche Verwaltungsfunktionen bieten und nicht nur Kontaktinformationen.

phoneNumber

an..15

O

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

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

AboID

ans..64

O

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

RefNr

an..50

O

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

ChargeAmount

n..10

M

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)

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

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




Kampagnenparameter (optional)

CampaignType

ans..13

O

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

CampaignPrice

n..10

C

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

CampaignEnd

dttm

C

Erforderlich für PRICECAMPAIGN: Kampagnenenddatum (ISO 8601)

CampaignIntervalUnit

ans..5

C

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

CampaignIntervalCount

n..2

C

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

CampaignEventDate

dttm

C

Erforderlich für EVENTCAMPAIGN: Veranstaltungsdatum (ISO 8601)

CampaignEventText

ans..100

C

Erforderlich für EVENTCAMPAIGN: Veranstaltungsbeschreibung

Parameter zum Einrichten einer Vereinbarung für wiederkehrende Zahlungen mit VIPPS


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameResponse_IntroURL
PageWithExcerptReuse API

Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1772099324323_392237130
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMID
pagemid
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
namePayID
pagePayID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameXID
pageXID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameTransID
pageTransID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameStatus_OK_AUTHORIZE_REQUEST
pageStatus
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameDescription
pageDescription
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCode
pageCode
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
namePlain
pagePlain
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCustom
pageCustom
typepage

Key

Format

CND

Beschreibung

BillingAgreementID

ans..64

M

Von VIPPS vergebene Kennung der Vereinbarung

RedirectUrl

ans..256

M

URL, zu der der Kunde zur Vertragsbestätigung weitergeleitet werden soll

Antwort-Parameter zum Einrichten einer Vereinbarung für wiederkehrende Zahlungen mit VIPPS


Wiederkehrende Zahlung (RTF=R) für VIPPS anlegen

Es gibt zwei Arten wiederkehrender Zahlungen bei VIPPS:

  • Erstzahlung: Wird automatisch mit RTF=I beim Einrichten der Vereinbarung angelegt
  • Regelmäßige/wiederkehrende Zahlung: Wird mit RTF=R für bestehende Vereinbarungen angelegt (dieser Abschnitt)

Um eine wiederkehrende Zahlung bei VIPPS anzulegen, verwenden Sie bitte die folgende URL:

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameBaseURL
PageWithExcerptWording (veraltet)
vipps.aspx

 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1772099341443_669482986
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMerchantID
pageMerchantID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameTransID
pageTransID
typepage

Key

Format

CND

Beschreibung

Amount

n..10

M

Zahlungsbetrag in der kleinsten Währungseinheit

Currency

a3

M

Währung (muss mit der Währung der Vereinbarung übereinstimmen)

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMAC
pageMAC
typepage

Key

Format

CND

Beschreibung

OrderDesc

ans..100

M

Für den Kunden sichtbare Beschreibung der Zahlung

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameURLSuccess
pageURLSuccess
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameURLFailure
pageURLFailure
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameResponse
pageResponse
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameURLNotify
pageURLNotify
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
namePlain
pagePlain
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCustom
pageCustom
typepage

Key

Format

CND

Beschreibung

RTF

a1

M

Muss R sein, um eine wiederkehrende Zahlung anzulegen

BillingAgreementID

ans..64

M

Vereinbarungskennung, gegen die abgerechnet werden soll (aus der Antwort vom Einrichten der Vereinbarung)

DueDate

a10

M

Wann die Zahlung verarbeitet werden soll (Format JJJJ-MM-TT).Muss mindestens 2 Tage im Voraus erfolgen (Produktion) bzw. 1 Tag (Testumgebung).

AboID

ans..64

O

Externe Abonnement-ID

Parameter zum Anlegen einer wiederkehrenden Zahlung bei VIPPS


Hinweis zur Zahlungsabwicklung: 

  • DIRECT_CAPTURE: Der Betrag wird am Fälligkeitstag sofort abgebucht (einstufige Zahlung)
  • RESERVE_CAPTURE: Der Betrag wird am Fälligkeitstag reserviert und erfordert eine explizite Buchung innerhalb von:
    • 14 Tagen (MobilePay)
    • 180 Tagen (VIPPS Norwegen)


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameResponse_IntroURL
PageWithExcerptReuse API

Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1772099358007_-1116055731
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMID
pagemid
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
namePayID
pagePayID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameXID
pageXID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameTransID
pageTransID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameStatus_OK_FAILED
pageStatus
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameDescription
pageDescription
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCode
pageCode
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
namePlain
pagePlain
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCustom
pageCustom
typepage

Key

Format

CND

Beschreibung

BillingAgreementID

ans..64

M

Von VIPPS vergebene Kennung der Vereinbarung

RedirectUrl

ans..256

M

URL, zu der der Kunde zur Vertragsbestätigung weitergeleitet werden soll

Antwort-Parameter beim Anlegen einer wiederkehrenden Zahlung bei VIPPS


Beenden/Kündigen einer Vereinbarung für wiederkehrende Zahlungen (RTF=C) bei VIPPS

Die Kündigung der Vereinbarung erfolgt über vipps.aspx mit RTF="C":

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameBaseURL
PageWithExcerptWording (veraltet)
vipps.aspx

 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1772099373977_847908611
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMerchantID
pageMerchantID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameTransID
pageTransID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMAC
pageMAC
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameURLSuccess
pageURLSuccess
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameURLFailure
pageURLFailure
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameResponse
pageResponse
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameURLNotify
pageURLNotify
typepage

Key

Format

CND

Beschreibung

RTF

a1

M

Muss C sein, um die Vereinbarung zu beenden

BillingAgreementID

ans..64

M

Zu beendende Vereinbarungskennung

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
namePlain
pagePlain
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCustom
pageCustom
typepage

Parameter zum Kündigen einer Vereinbarung für wiederkehrende Zahlungen bei VIPPS


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameResponse_IntroURL
PageWithExcerptReuse API

Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1772099386445_-815831165
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMID
pagemid
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
namePayID
pagePayID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameXID
pageXID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameTransID
pageTransID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameStatus_OK_FAILED
pageStatus
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameDescription
pageDescription
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCode
pageCode
typepage

Key

Format

CND

Beschreibung

BillingAgreementID

ans..64

M

Vereinbarungskennung, die beendet wurde

Antwort-Parameter zum Kündigen einer Vereinbarung für wiederkehrende Zahlungen bei VIPPS


Wichtige Hinweise zu wiederkehrenden Zahlungen

Parameter Telefonnummer

  • Format: 0-15 numerische Ziffern zulässig
  • Bedingte Übermittlung an VIPPS:
    • Wenn 10-15 Ziffern angegeben sind → Wird als Customer.phoneNumber an VIPPS zum Vorausfüllen gesendet
    • Wenn weniger als 10 Ziffern oder keine angegeben sind → Wird in der VIPPS-Anfrage weggelassen, der Kunde gibt die Nummer manuell ein
  • Zahlung wird nie blockiert: Ungültige oder fehlende Telefonnummern verhindern die Zahlungsabwicklung nicht
  • Empfohlene Vorgehensweise: Geben Sie die Ländervorwahl mit an (z. B. 4746586653 für norwegische Nummern), um die automatische Vorbelegung zu ermöglichen

Verwaltung der Vereinbarung

  • Der Kunde hat nach dem Anlegen 10 Minuten Zeit, um die Vereinbarung zu akzeptieren
  • Sowohl Händler als auch Kunde können Vereinbarungen kündigen
  • Nach der Kündigung (Status "STOPPED") kann eine Vereinbarung nicht reaktiviert werden
  • Falls wiederkehrende Zahlungen wieder aufgenommen werden sollen, muss eine neue Vereinbarung eingerichtet werden

Zahlungsabwicklung

  • Fälligkeitsanforderung: Zahlungen müssen mindestens 2 Tage im Voraus (Produktionsumgebung) oder 1 Tag im Voraus (Testumgebung) angelegt werden
  • DIRECT_CAPTURE: Der Betrag wird sofort am Fälligkeitstag abgebucht (einstufige Zahlung)
  • RESERVE_CAPTURE: Der Betrag wird am Fälligkeitstag reserviert und muss explzit gebucht werden innerhalb von:
    • 14 Tagen (MobilePay)
    • 180 Tagen (VIPPS Norwegen)
  • Mehrfache Teilbuchungen und Teilgutschriften werden unterstützt

Preismodelle

  • LEGACY: ester, wiederkehrender Betrag, der bei Vertragserstellung über den Parameter Amount angegeben wird
  • VARIABLE: Flexibler Betrag pro Abbuchung. Der Händler muss den empfohlenen Höchstbetrag (suggestMaxAmount) angeben.Mindestbeträge: 100 NOK øre, 1 DKK øre, 1 EUR Cent.

Kampagenunterstützung

Kampagnen ermöglichen temporäre Preisänderungen:

  • PRICECAMPAIGN: Sonderpreis bis zu einem bestimmten Enddatum
  • PERIODCAMPAIGN: Sonderpreis für eine definierte Anzahl von Intervallen
  • EVENTCAMPAIGN: Sonderpreis bis zu einem bestimmten Ereignisdatum

Kündigungen durch den Nutzer

Kunden können Vereinbarungen direkt in ihrer VIPPS/MobilePay-App kündigen. In diesem Fall:

  • erhält der Händler eine Benachrichtigung über URLNotify
  • werden alle ausstehenden Zahlungen automatisch storniert
  • ändert sich der Status der Verinbarung auf STOPPED


Beispiele

Beispiel 1: Vereinbarung ohne Erstzahlung einrichten

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamevipps_example1
DisableCachingtrue
PageWithExcerptEN:VIPPS


Beispiel 2: Vereinbarung mit rabattierter Erstzahlung einrichten

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamevipps_example2
DisableCachingtrue
PageWithExcerptEN:VIPPS


Beispiel 3: Wiederkehrende Zahlung anlegen

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamevipps_example3
DisableCachingtrue
PageWithExcerptEN:VIPPS


Beispiel 4: Vereinbarung kündigen

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamevipps_example4
DisableCachingtrue
PageWithExcerptEN:VIPPS


Buchung

Buchungen sind über eine Server-zu-Server-Kommunikation möglich. Um eine Buchung (Capture) über eine Server-zu-Server-Verbindung auszuführen, verwenden Sie bitte folgende URL:

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameBaseURL
PageWithExcerptWording (veraltet)
capture.aspx

 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1772099416736_-2028217373
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMerchantID
pageMerchantID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
namePayID_Capture
pagePayID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameTransID
pageTransID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameAmount
pageAmount
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCurrency
pageCurrency
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMAC
pageMAC
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameReqId-ans..32
pageReqId
typepage

Parameter für Buchungen von VIPPS


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameResponse_Intro
PageWithExcerptReuse API

Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1772099445633_-1856120505
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMID
pagemid
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
namePayID
pagePayID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameXID
pageXID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameTransID
pageTransID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameStatus_OK_FAILED
pageStatus
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameDescription
pageDescription
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCode
pageCode
typepage

Ergebnis-Parameter für Buchungen von VIPPS


Gutschrift mit Referenz

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameCredit_Intro
PageWithExcerptReuse API

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameBaseURL
PageWithExcerptWording (veraltet)
credit.aspx

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1772099459911_1245385550
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMerchantID
pageMerchantID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
namePayID_Credit
pagePayID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameTransID
pageTransID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameAmount
pageAmount
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCurrency
pageCurrency
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMAC
pageMAC
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameReqId-ans..32
pageReqId
typepage

Parameter für Gutschrift von Zahlungen mit VIPPS


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameResponse_Intro
PageWithExcerptReuse API

Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1772099474247_1133785091
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMID
pagemid
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
namePayID
pagePayID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameXID
pageXID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameTransID
pageTransID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameStatus_OK_FAILED
pageStatus
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameDescription
pageDescription
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCode
pageCode
typepage

Antwort-Parameter für Gutschrift von Zahlungen mit VIPPS


Storno

Stornierungen sind über eine Server-zu-Server-Kommunikation möglich. Um eine Zahlung über eine Server-zu-Server-Verbindung zu stornieren, verwenden Sie bitte folgende URL:

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameBaseURL
PageWithExcerptWording (veraltet)
reverse.aspx

 

Hinweis: Die Reverse.aspx macht nicht nur Autorisierungen, sondern IMMER DEN LETZTEN TRANSAKTIONSSCHRITT rückgängig! Falls die letzte Transaktion eine Buchung war, löst die Re-verse.aspx z.B. eine Gutschrift aus. Es ist daher größte Vorsicht geboten, und die Nutzung erfolgt auf eigene Gefahr. Wir empfehlen, vor Nutzung der Reverse.aspx den Transaktionsstatus mit der Inquire.aspx prüfen.

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1772099493471_-454765268
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMerchantID
pageMerchantID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
namePayID_Reverse
pagePayID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameTransID
pageTransID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameAmount
pageAmount
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCurrency
pageCurrency
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMAC
pageMAC
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameReqId-ans..32
pageReqId
typepage

Parameter für Storno von VIPPS


Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameResponse_Intro
PageWithExcerptReuse API

Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1772099511896_930890045
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameMID
pagemid
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
namePayID
pagePayID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameXID
pageXID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameTransID
pageTransID
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameStatus_OK_FAILED
pageStatus
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameDescription
pageDescription
typepage

Table Excerpt Include
isFirstTimeEntertrue
statictrue
v2
nameCode
pageCode
typepage

Ergebnis-Parameter für Storno von VIPPS