Konfigurationen
Folgende Einstellungen sind relevant für die Konfiguration der Zahlungsart stripe:Module
Folgende Module sind relevant für die Integration der Zahlungsart stripe im Bestellprozess:- $wsStripe - stripe-Zahlungsarten Modul
- $wsCheckout - Checkout-Zustand, Adressen, Versand, Zahlung, Probleme, Summen
- $wsActions - Aktionen erzeugen und auswerten
- $wsAccount - Login-Status, E-Mail, Adressen, loadAddress()
- $wsViews - Aktuelle URL, Zielseiten, View-URLs
- $wsBasket - Warenkorb und Bestellübersicht
- $wsConfig - Konfigurationswerte, zum Beispiel Anreden und Währung
Aktionen
Folgende Aktionen sind relevant für die Integration der Zahlungsart stripe:Zusätzliche relevante Informationen
Folgende zusätzlichen Inhalte müssen für die Zahlungsart integriert werden.Frontend-Integration
Stripe stellt ein eigenes JavaScript-SDK bereit, das in das Template eingebunden werden muss. Es übernimmt die Darstellung der Zahlungsfelder und die Kommunikation mit Stripe. HTML-StrukturFolgender HTML-Block muss im Template plaziert werden:
#wsStripePaymentElementist der Container, in den Stripe die Zahlungsfelder (z.B. Kreditkartennummer, PayPal-Button etc.) automatisch einbettet- Das Formular sendet beim Klick auf “Mit Stripe bezahlen” den Bezahlvorgang ab
Der folgenden Script-Block muss direkt nach dem HTML-Block eingefügt werden. Er muss in
{{ autoescape “js” }} eingeschlossen sein, damit Template-Variablen im JavaScript-Kontext korrekt verarbeitet werden.
Der Ablauf im Script ist folgender:
- Stripe initialisieren - Das SDK wird mit den Zugangsdaten aus $wsStripe.configuration gestartet
- Zahlungsfelder anzeigen - Stripe rendert die Zahlungsauswahl (Kreditkarte, PayPal etc.) in den
#wsStripePaymentElement-Container. Die Adresseingabefelder von Stripe werden dabei deaktiviert, weil die Adresse des Kunden bereits im Shop bekannt ist und automatisch übergeben wird. - Bezahlung auslösen - Beim Absenden des Formulars werden die eingegebenen Zahlungsdaten zusammen mit der Rechnungsadresse aus $wsAccount an Stripe geschickt. Stripe gibt dafür ein Confirmation-Token zurück.
- Token an den Shop senden - Das Token wird an den Shop übermittelt, der damit den eigentlichen Zahlungsvorgang bei Stripe startet.
- Ergebnis verarbeiten - Schlägt die Zahlung fehl, wird eine Fehlermeldung angezeigt. Ist eine zusätzliche Bestätigung nötig (z.B. 3D Secure), übernimmt Stripe das automatisch.
- Weiterleitung - Nach erfolgreicher Zahlung wird der Kunde zur Bestellbestätigungsseite weitergeleitet.
Weiterführende Links
- Generelle Doku für das Stripe Frontend: https://docs.stripe.com/js
