Anwendungsfälle
Unterstützte Anwendungsfälle | Unterstützte Schnittstelle | ||||
---|---|---|---|---|---|
Anwendungsfall | Beschreibung | Einfacher Prozess | 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
Prozessablauf Instant Payment
Paygate-Schnittstelle
Datenformate: a alphabetisch as alphabetisch mit Sonderzeichen n numerisch an alphanumerisch ans alphanumerisch mit Sonderzeichen ns numerisch mit Sonderzeichen bool Bool’scher Ausdruck (true oder false) 3 feste Länge mit 3 Stellen/Zeichen ..3 variable Länge mit maximal 3 Stellen/Zeichen enum Aufzählung erlaubter Werte dttm ISODateTime (JJJJ-MM-TTThh:mm:ss) Abkürzungen: CND Bedingung (condition) M Pflicht (mandatory) O optional C bedingt (conditional) Hinweis: Bitte beachten Sie, dass die Bezeichnungen der Parameter in Groß- oder Kleinbuchstaben zurückgegeben werden können.Definitionen
Format Beschreibung Abkürzung Beschreibung Kommentar Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein Wenn ein Parameter optional ist, dann kann er vorhanden sein, ist aber nicht erforderlich Wenn ein Parameter bedingt ist, dann gibt es eine Bedingungsregel, die angibt, ob er Pflicht oder optional ist
Aufruf der Schnittstelle für Instant Banking
Um eine Zahlung per Online-Überweisung mit Instant Payment abzuwickeln, verwenden Sie bitte die folgende URL:
https://www.computop-paygate.com/OpenBanking.aspx |
Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp. Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:
Parameter für Online-Überweisungen mit Instant Payment
Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das Paygate an Ihre URLSuccess, URLFailure und URLNotify übergibt. Wenn Sie den Parameter Response=encrypt angegeben haben, werden die folgenden Parameter mit Blowfish verschlüsselt an Ihr System übergeben: es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
Ergebnis-Parameter für URLSuccess, URLFailure und URLNotify bei Instant Payment
Einrichtung beim OpenBanking-Anbieter Token.io
Da Computop keinen Zugriff auf Ihre Einrichtung bei Token.io hat, müssen Sie uns die erforderlichen Informationen für die Einrichtung im Computop Paygate senden.
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 Computop Paygate – in Klartext, nicht als Screenshot:
- 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 Computop Paygate könnte wie folgt aussehen:
My Token.io setup
Anpassung und Test mit OpenBanking-Anbieter Token.io
Wie eine Zahlung aussieht
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“):
Webhook
Der Webhook muss technisch auf Computop Paygate eingestellt sein; URL: https://www.computop-paygate.com//OpenBankingComplete.aspx
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):
Nachdem Sie Ihr Händlerlogo hochgeladen und Ihre CSS-Stile angepasst haben, kann das neue WebApp-Layout über den Payload Builder getestet werden:
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)
Ein neues Tab/Fenster öffnet sich mit dem neuen Design:
Settings → Authentication Keys
Bitte generieren Sie einen API-Schlüssel für Ihre Konfiguration und senden ihn an den Computop Helpdesk:
Wir benötigen außerdem Ihre MemberID und weitere Informationen, die im nächsten Abschnitt angezeigt werden.
Settings → Member Information
Die hier gezeigten Informationen sind ebenfalls für die Einrichtung im Computop Paygate erforderlich:
Settings → Beneficiary
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:
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.