Prozess: Expresszahlarten

Expresszahlarten bieten einen beschleunigten Checkout-Ablauf: Der Kunde wird früh im Bestellprozess zum Payment Service Provider (PSP) weitergeleitet, wo er bereits hinterlegte Liefer- und Rechnungsdaten bestätigt. Die Kundendaten, insbesondere Liefer- und Rechnungsadresse, werden vom PSP an collana pay zurückgeliefert und dem Webshop per Callback bereitgestellt. Expresszahlarten erfordern daher einen angepassten Prozessablauf im Vergleich zu regulären Zahlarten.

Unterstützte Expresszahlarten

Expresszahlarten werden typischerweise als markentypische Buttons im Webshop angezeigt und zählen zu den sogenannten Buttonzahlarten. Beispiele unterstützter Expresszahlarten in collana pay:

• PayPal Express
• Amazon Pay
• Apple Pay
• Google Pay

Unterschiede zu regulären Zahlarten

Prozessablauf

Der folgende Ablauf beschreibt die aktuelle Standardintegration am Beispiel von PayPal Express — der Prozess gilt analog für andere Expresszahlarten.

1. Create: Transaktion anlegen

Der Webshop legt eine neue Transaktion über den transactions-Endpunkt der collana pay API an. Liefer- und Rechnungsadresse werden dabei leer übergeben, da diese erst im Verlauf des Expressprozesses vom PSP zurückgeliefert werden. collana pay gibt synchron transactionId und interactionId zurück; ein asynchroner Callback bestätigt die erfolgreiche Anlage.

2. Prepare: Express-Session vorbereiten

Der Webshop ruft den prepares-Endpunkt auf. collana pay kommuniziert mit dem PSP, um eine Express-Session zu erzeugen, und fordert dabei das JavaScript für den Express-Button an. collana pay schickt einen Callback mit Status Pending an den Webshop, der scriptSrcUri und scriptTagId enthält.

3. Express-Button anzeigen und Kundeninteraktion

Der Webshop bettet das JavaScript aus scriptSrcUri in das Frontend ein und verwendet scriptTagId als ID des Container-Elements. Der Express-Button wird dadurch im Shop gerendert. Klickt der Kunde auf den Button, wird er zum PSP weitergeleitet, wo er sich authentifiziert und die Freigabe für die Zahlung erteilt. Nach erfolgreicher Interaktion wird der Kunde per Redirect zurück in den Webshop geleitet. collana pay übermittelt dem Webshop per Callback die vom PSP zurückgelieferten Kundendaten (Liefer- und Rechnungsadresse).

4. Reserve: Zahlung reservieren

Der Webshop stößt die Reservierung über den reservations-Endpunkt an. collana pay leitet die Anfrage an den PSP weiter. Der PSP bestätigt zunächst mit Status Pending (Callback an den Webshop), anschließend mit Successful (abschließender Callback). Bei AutoCapture-Zahlarten erfolgt zusätzlich ein Callback nach dem automatischen Capture.

5. Optional: Händlerreferenz aktualisieren

Nach Abschluss der Reservierung kann der Webshop die Transaktion über den PATCH merchantReference-Endpunkt mit einer finalen Händlerreferenz (z. B. der Bestellnummer) versehen. collana pay bestätigt den Vorgang per Callback.

Prozessdiagramm

Beispielhaft wird im Prozessdiagramm der Expressflow für PayPal Express dargestellt:

Time to Live (TTL)

Express-Transaktionen sind in collana pay zeitlich begrenzt gültig. Wird ein Expressvorgang nicht innerhalb von 24 Stunden abgeschlossen, löscht collana pay die Transaktion automatisch. Eine Weiterverarbeitung ist danach nicht mehr möglich. Der Webshop muss in diesem Fall einen neuen Expressvorgang starten.

Weiterentwicklung der Integration