Anwendungsfälle
Unterstützte Anwendungsfälle | Unterstützte Schnittstelle per Token.io | Unterstützte Schnittstelle per Tink | ||||||
---|---|---|---|---|---|---|---|---|
Anwendungsfall | Beschreibung | Einfacher Prozess | S-2-S | Formular | HPP | S-2-S | Formular | HPP |
Autorisierung + Buchung | Der Händler möchte die Zahlung autorisieren und bei Lieferung buchen |
| ||||||
Verkauf (einmalig) | Der Händler möchte über OpenBanking Geld vom Kunden einziehen |
| ||||||
Voll- oder Teilgutschrift | Der Händler möchte dem Kunden nach erfolgreicher Zahlung etwas Geld zurückerstatten |
| kommt bald | |||||
Voll- oder Teilstorno | Der Händler möchte eine noch nicht abgeschlossene Zahlung stornieren |
|
Diagramm zum Prozessablauf per Token.io
Multiexcerpt include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Prozessablauf Instant Payment
Diagramme zum Prozessablauf per Tink
Anwendungsfall 1
Wenn der Kunde für zukünftige Transaktionen bei diesem Händler sein Einverständnis gibt, weitere Transaktionen ohne SCA-Prozess durchzuführen.
Multiexcerpt include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Prozessablauf Instant Payment
Anwendungsfall 2
Wenn der Kunde für zukünftige Transaktionen bei diesem Händler sein Einverständnis nicht gibt, weitere Transaktionen ohne SCA-Prozess durchzuführen.
Multiexcerpt include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Prozessablauf Instant Payment
Anwendungsfall 3
Wenn die Einwilligung wie in Anwendungsfall 1 erhalten wurde und derselbe Kunde innerhalb von 90 Tagen eine weitere Transaktion bei demselben Händler durchführt, kann der Händler eine Anfrage wie unten beschrieben senden, um die Challenge für den Kunden zu vermeiden.
Multiexcerpt include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Prozessablauf Instant Payment
Multiexcerpt include | ||||||
---|---|---|---|---|---|---|
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Definition PageWithExcerpt Definition DE
Aufruf der Schnittstelle für Instant Banking per Token.io
Um eine Zahlung per Online-Überweisung mit Instant Payment abzuwickeln, verwenden Sie bitte die folgende URL:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
Table Filter | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für Online-Überweisungen mit Instant Payment Payment
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_IntroURL PageWithExcerpt Reuse API
Table Filter | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Ergebnis-Parameter für URLSuccess, URLFailure und URLNotify bei Instant Payment
Aufruf der Schnittstelle für Instant Banking per Tink
Zahlungsanforderung mit Rückerstattungsoption anlegen
Um eine Zahlung per Online-Überweisung mit Instant Payment abzuwickeln, verwenden Sie bitte folgende URL:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
Table Filter | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für Online-Überweisungen mit Instant Payment
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_IntroURL PageWithExcerpt Reuse API
Table Filter | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Ergebnis-Parameter für URLSuccess, URLFailure und URLNotify bei Instant Payment
Gutschrift mit Referenz
Gutschriften sind über eine Server-zu-Server-Kommunikation möglich. Das
erlaubt nur Gutschriften für Instant Payment, die sich auf eine vorangegangene Transaktion über das Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Name PageWithExcerpt Wording
beziehen. Die Höhe der Gutschrift ist auf den Betrag der Sale-Transaktion beschränkt. Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Name PageWithExcerpt Wording
Um eine Gutschrift mit Referenztransaktion auszuführen, verwenden Sie bitte folgende URL:
|
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Request_Intro PageWithExcerpt Reuse API
Table Filter | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Parameter für Gutschrift von Zahlungen mit Instant payments per Tink
Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Response_Intro PageWithExcerpt Reuse API
Table Filter | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
Antwort-Parameter für Gutschrift von Zahlungen mit Instant payments per Tink
Einrichtung beim OpenBanking-Anbieter Tink
Da
keinen Zugriff auf Ihre Einrichtung bei Tink hat, müssen Sie uns die erforderlichen Informationen für die Einrichtung im Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Partner-Name PageWithExcerpt Wording
senden. Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Name PageWithExcerpt Wording
Nach Vertragsunterzeichnung erhalten Sie Zugriff auf Ihre Tink-Console.
Bitte melden Sie sich an Ihrer Tink-Console (https://console.tink.com/login) an, richten Ihr Konto wie unter https://docs.tink.com/resources/console/set-up-your-tink-account beschrieben ein und senden die Informationen zum
– in Klartext, nicht als Screenshot: Multiexcerpt include SpaceWithExcerpt DE MultiExcerptName Platform-Name PageWithExcerpt Wording
client_id
: das ist die eindeutige ID für Ihre App.Dieser Schlüssel ist öffentlich und sofort verfügbar, sobald Sie eine App erstellen.client_secret
: das ist ein geheimer Schlüssel für Ihre App.Dieser Schlüssel authentifiziert Ihre App bei der Tink-API.
Einrichtung beim OpenBanking-Anbieter Token.io
Da
keinen Zugriff auf Ihre Einrichtung bei Token.io hat, müssen Sie uns die erforderlichen Informationen für die Einrichtung im Multiexcerpt include SpaceWithExcerpt ENDE MultiExcerptName Partner-Name PageWithExcerpt EN:Wording
senden. Multiexcerpt include SpaceWithExcerpt ENDE MultiExcerptName Platform-Name PageWithExcerpt EN:Wording
Nach Vertragsunterzeichnung erhalten Sie Zugriff auf Ihr Token.io-Dashboard.
Bitte melden Sie sich an Ihrem Token.io-Dashboard (https://dashboard.token.io/) an und senden die Informationen zum
– in Klartext, nicht als Screenshot: Multiexcerpt include SpaceWithExcerpt ENDE MultiExcerptName Platform-Name PageWithExcerpt EN:Wording
- Firmenname → wie in den Account Settings -> Company information
- MemberId, Alias, Token Public Key → entnommen aus Settings -> Member Information
- API Key → entnommen aus Settings -> Authentication Keys
- Liste Ihrer Händlerbankkonten (Begünstigte) → entnommen aus Settings -> Beneficiary
Eine Beispiel-E-Mail an
könnte wie folgt aussehen: Multiexcerpt include SpaceWithExcerpt ENDE MultiExcerptName PlatformPartner-Name PageWithExcerpt EN:Wording
Panel | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
My Token.io setup
|
Anpassung und Test mit OpenBanking-Anbieter Token.io
Wie eine Zahlung aussieht
Table Filter | ||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||
|
So passen Sie Ihr Zahlungs- / Token.io-Konto an
Nachdem Sie den Vertrag mit dem Open-Bank-Betreiber (Token.io) unterzeichnet haben, erhalten Sie Zugriff auf dessen Dashboard.
- Produktions-URL: https://dashboard.token.io/
Dort können Sie Folgendes einrichten:
- Ihre Benutzerdaten und Firmeninformationen (z.B. Firmenname, Rechnungsdetails, ...)
Settings → Configuration
General
Hier kann der „Display name“ geändert werden. Dies ist der dem Verbraucher angezeigte Empfänger („An“ / „Empfänger“):
Multiexcerpt include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Webhook
Der Webhook muss technisch auf
eingestellt sein; URL: Multiexcerpt include SpaceWithExcerpt ENDE MultiExcerptName Platform-Name PageWithExcerpt EN:Wording
/OpenBankingComplete.aspx Multiexcerpt include SpaceWithExcerpt ENDE MultiExcerptName BaseURL PageWithExcerpt EN:Wording
Multiexcerpt include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Web App – Bank selection
Sie können die Bankauswahl für Ihre Verbraucher einschränken. Es wird empfohlen, „Enable all banks“ zuzulassen. Der Verbraucher kann dann jede unterstützte Bank auswählen.
CSS (Styling der Token.io Web-App (die Ihrem Kunden angezeigt wird)
Es ist möglich, Ihr eigenes Händlerlogo hochzuladen und das CSS-Design der Web-App anzupassen (wird dem Kunden angezeigt):
Multiexcerpt include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Nachdem Sie Ihr Händlerlogo hochgeladen und Ihre CSS-Stile angepasst haben, kann das neue WebApp-Layout über den Payload Builder getestet werden:
Multiexcerpt include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Nach der CSS-Änderung kann eine Testzahlung zur Überprüfung des Designs veranlasst werden:
- API-Schlüssel und MemberID werden automatisch vom Payload Builder festgelegt
- (4) Die Beschreibung muss für jede Zahlung eindeutig sein
- (5) Der Betrag muss mit Dezimalpunkt angegeben werden
- (6) Die Währung muss EUR sein
- (7) IBAN ist die IBAN des Händlers, d. h. eine beliebige IBAN Ihres Begünstigten
- (8) Die BIC des Händlers ist optional → leer lassen
- (9) Zum Testen verwenden Sie eine beliebige URL, z.B. https://www.google.com
- (10) Klicken Sie auf "Generate"
Dann klicken Sie auf Test (1)
Multiexcerpt include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Ein neues Tab/Fenster öffnet sich mit dem neuen Design:
Multiexcerpt include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Bitte generieren Sie einen API-Schlüssel für Ihre Konfiguration und senden ihn an den
: Multiexcerpt include SpaceWithExcerpt ENDE MultiExcerptName Helpdesk-Name PageWithExcerpt EN:Wording
Multiexcerpt include SpaceWithExcerpt EN MultiExcerptName TokenKey DisableCaching true PageWithExcerpt EN:Instant Payment
Wir benötigen außerdem Ihre MemberID und weitere Informationen, die im nächsten Abschnitt angezeigt werden.
Anchor | ||||
---|---|---|---|---|
|
Die hier gezeigten Informationen sind ebenfalls für die Einrichtung im
erforderlich: Multiexcerpt include SpaceWithExcerpt ENDE MultiExcerptName Platform-Name PageWithExcerpt EN:Wording
Multiexcerpt | ||
---|---|---|
| ||
Anchor | ||||
---|---|---|---|---|
|
Für Ihr Händlerkonto sind möglicherweise mehrere Bankkonten konfiguriert. Jedes Bankkonto kann einen Kontonamen haben (von Ihnen vergeben) und ist definiert
- entweder mit IBAN/BIC (SEPA-basiert)
- oder mit Kontonummer / Bankleitzahl (FasterPayments / UK)
Ein Beispiel-Setup könnte wie folgt aussehen:
Multiexcerpt include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Testen im Sandbox-Modus
Solange Ihr OpenBanking-Setup nicht im Produktionsmodus eingerichtet ist, können Sie es im Sandbox-Modus testen.
Bitte verwenden Sie daher die hier gezeigten Testdaten: Test Instant Payment.