Über paydirekt

Allgemeines zu paydirekt

paydirekt ist ein neuer Online-Bezahlservice aller deutschen Banken und Sparkassen und daher genauso vertrauenswürdig wie das eigene Finanzinstitut. Dreh- und Angelpunkt von paydirekt ist das bewährte Girokonto, über welches die gesamte Abwicklung vorgenommen wird.

Der Käufer meldet sich für paydirekt über das Online-Banking seiner Hausbank an. Jede Zahlung wird durch die Hausbank des Käufers autorisiert und unmittelbar am Girokonto verbucht. Die Authentifikation des Käufers erfolgt durch ein adaptives Authentifizierungsverfahren. Bei jeder Zahlung ist zugleich eine Altersverifikation möglich.

Vorteile für den Händler sind die einfache Anbindung von paydirekt in das Shopsystem, eine hohe Transaktionssicherheit durch die Abwicklung der beteiligten Banken und Sparkassen und deren Bonitätsprüfung, die bestehende Zahlungsgarantie, sobald nach positiver Zahlungsbestätigung die Buchung ausgelöst ist, sowie die einfache Handhabung von Retouren und Reklamationen.

Weitere Informationen finden Sie auch auf der Webseite von paydirekt (https://www.paydirekt.de).

Diagramm zum Prozessablauf

paydirekt Prozessablauf

Multiexcerpt include
SpaceWithExcerpt DE MultiExcerptName Platform-Kurz PageWithExcerpt Wording

-Schnittstelle

Aufruf der paydirekt-Schnittstelle

Eine Zahlung mittels paydirekt kann in zwei Schritten erfolgen, wobei zunächst eine Zahlung für eine Bestellung initialisiert wird, bevor Sie diese dann beim Versand der Ware separat buchen. Alternativ kann die Zahlung auch in einem Schritt als Sale-Transaktion erfolgen. Die Folgetransaktionen erfolgen dann über eine Server-zu-Server-Verbindung. Damit können Sie diese Zahlungen buchen oder bei einer Rückgabe eine Gutschrift erteilen.

Um eine Zahlung mit paydirekt über ein

Parameter für Zahlungen mit paydirekt

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

paydirekt oneKlick

Im Gegensatz zum Standard-Checkout muss sich der Kunde für oneKlick einmalig registrieren. Die Registrierung stellt im

Optional kann eine URL angegeben werden, an die eine Benachrichtigung geschickt wird, wenn der Kunde die E-Mail bestätigt oder widerrufen hat. Diese URL kann statisch in der Händlerkonfiguration hinterlegt werden oder durch den Request-Parameter "URLConfirm" übergeben werden.

Bei einem oneKlick-Checkout muss die BillingAgreementID ans

oneKlick-Registrierung

Die oneKlick-Registrierung kann als separater Prozess oder im Zuge eines Checkouts erfolgen. Die separate Registrierung verläuft über ein eigenes Formular. Nach der Registrierung erfolgen alle Folgetransaktionen über eine Server-zu-Server-Verbindung. Mit oneKlick können Sie Zahlungen trennen in Autorisierung und Buchung oder sofort buchend (SALE).

Die separate oneKlick-Registrierung als auch die Registrierung bei Checkout erfolgen immer über das

Hinweis: Die DeviceID oder der DeviceFingerPrint müssen für jedes Endgerät des Kunden eindeutig sein. Paydirekt bietet für iOS und Android ein SDK an, um eine eindeutige DeviceId zu erzeugen. Für Webanwendungen können Libraries wie Fingerprint.js ( https://github.com/Valve/fingerprintjs2 ) verwendet werden, um einen eindeutigen Fingerprint zu erhalten.

Parameter für oneKlick-Registrierung mit paydirekt

usageAgreement

Beispiel usageAgreement als JSON-String

{
   "amount":{
      "amount":50,
      "currency":"EUR"
   },
   "startDate":"2019-09-01",
   "recurrenceInterval":{
      "intervalUnit":"WEEK",
      "interval":8
   }
}

Der im JSON-Format erstellte Parameter muß Base64 encodiert werden.

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

Die folgende Tabelle beschreibt die Ergebnis-Parameter, die das

Ergebnis-Parameter für URLConfirm bei paydirekt

Aufruf der paydirekt oneKlick-Schnittstelle

Zahlungen mit oneKlick sind mit Hilfe der BillingAgreementID über eine Server-zu-Server-Kommunikation möglich. Zahlungen mittels oneKlick sind als Autorisierung möglich, die dann separat gebucht werden muss, oder auch als Sale-Transaktion mit sofortiger Buchung.

Um eine oneKlick-Zahlung mit paydirekt über eine Server-zu-Server-Verbindung auszuführen, verwenden Sie bitte folgende URL:

Parameter für Zahlungen mit paydirekt oneKlick

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

Buchung

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

Parameter für paydirekt-Buchungen

Ergebnis-Parameter für paydirekt-Buchungen

Gutschrift mit Referenz

Gutschriften sind über eine Server-zu-Server-Kommunikation möglich. Gutschriften sind bis zum Betrag von 200% über Buchung möglich, wenn das vom

Parameter für Gutschrift von paydirekt-Zahlungen

Ergebnis-Parameter für Gutschrift von paydirekt-Zahlungen

Aufruf der Schnittstelle für Stornierungen

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

Parameter für Storno von paydirekt-Zahlungen

Ergebnis-Parameter für Storno von paydirekt-Zahlungen

Batch-Nutzung der Schnittstelle

Dieses Kapitel beschreibt die Parameter, die Sie im Datensatz (Record) für die Ausführung einer paydirekt-Zahlung übergeben müssen und welche Informationen Sie der Antwort-Datei über den Status des Zahlungsvorgangs entnehmen können.

Folgende Tabelle gibt eine Übersicht der pro Aktion jeweils möglichen Batch-Versionen und ihrer Besonderheiten:

Beschreibung der möglichen Batch-Versionen

Der Aufbau für eine paydirekt-Zahlung in einer einzureichenden Batch-Datei sieht folgendermaßen aus:

Beispiel für Master-MID-Funktion:

Beschreibung der Felder im Datensatz von Batch-Dateien

Der Record-Bereich in der Antwort-Datei zu Batch-Transaktionen sieht folgendermaßen aus:

Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien