Express-Checkout mit Stripe: einrichten, anbieten, prüfen

1. Knopf: Der Kunde wählt im Warenkorb eine Zahlart, etwa Apple Pay oder Google Pay.
2. Wallet: Im Zahlungsfenster wählt er Lieferadresse und Versandart. Der Shop berechnet dazu Versandkosten und Gesamtbetrag.
3. Prüfung: Nach der Zahlung fragt der Shop bei Stripe nach, ob das Geld eingegangen ist.
4. Bestellung: Erst dann legt er die Bestellung an. Kehrt der Kunde nach der Zahlung nicht zurück, legt der Shop sie später selbst an.

Im Shop

1. Modul öffnen: Unter Einstellungen → Checkout → Zahlungsarten das Modul „Stripe“ bearbeiten.
2. Aktivieren: „Bezahlung per Stripe“ einschalten und „Öffentlicher Schlüssel“ sowie „Geheimer Schlüssel“ aus Ihrem Stripe-Konto eintragen.
3. Zahlarten wählen: Die Tabelle „Zahlungsweisen“ mit dem Hilfetext „Wählen Sie hier, welche Zahlungsarten Sie über Stripe anbieten wollen.“ legt fest, welche der fünf Zahlarten aus der Übersicht unten der Express-Knopf zeigen darf. Dieselbe Tabelle bestimmt auch die Stripe-Zahlarten im normalen Bestellweg. Mehrere Zeilen sind möglich, etwa „Kreditkarten, ApplePay, GooglePay“ und „PayPal“.
4. Expresskauf erlauben: „Stripe-Checkout (Expresskauf) erlauben“ bleibt eingeschaltet, das ist die Vorgabe. Ausgeschaltet erscheint an keiner der drei Stellen ein Knopf.
5. Versandarten freigeben: Im Reiter „Versand und Zahlung“ des Moduls Stripe für die Versandarten freigeben, die das Wallet anbieten soll, und zusätzlich für „Versandkostenfrei“, auch wenn Sie diese Versandart gar nicht anbieten. Fehlt die Freigabe für „Versandkostenfrei“ oder für die Versandart, die im Warenkorb gewählt ist (ohne Wahl die günstigste), erscheint kein Knopf. Versandarten unter „Versandkosten werden nachträglich ermittelt (Versandmodule)“ (Einstellungen → Checkout → Versand/Verpackung) geben Sie für Stripe nicht frei: Für sie zöge das Wallet die Summe ohne Versand ein.
6. Speichern: Beim Speichern legt der Shop seinen Webhook-Endpunkt bei Stripe an oder ergänzt ihn. Über den Webhook erfährt er von Zahlungen, auch wenn der Kunde nicht in den Shop zurückkehrt.

Bei Stripe

• Domain registrieren: Registrieren Sie im Stripe-Dashboard jede Domain, auf der die Knöpfe erscheinen, auch Subdomains wie www, für Tests auch im Testmodus. Für Apple Pay ist das Pflicht. Stripe sieht die Registrierung auch für Google Pay, Link, PayPal und Amazon Pay vor. Registriert wird auf der Seite „Zahlungsmethoden-Domains“ (Anleitung von Stripe). Der Shop hat dafür keine eigene Funktion.
• Zahlarten aktivieren: Welche Knöpfe Stripe zeigt, hängt auch davon ab, welche Zahlarten in Ihrem Stripe-Konto aktiv sind. Einige müssen Sie dort zuerst aktivieren.
• Klarna: Die Tabelle „Zahlungsweisen“ steuert Klarna im Express-Knopf nicht. Ist Klarna in Ihrem Stripe-Konto aktiv, kann Stripe es dort zusätzlich zeigen. Die Bestellung entsteht dann voraussichtlich wie bei PayPal erst über die Wiederherstellung.
• Gerät des Kunden: Ein Wallet-Knopf erscheint nur, wenn Browser, Gerät und Währung die Zahlart unterstützen und der Kunde sie eingerichtet hat. Ohne eingerichtetes Google Pay zeigt Stripe zum Beispiel keinen Google-Pay-Knopf.

Hinweis statt Knopf

Auf dem Express-Weg überspringt der Kunde die Schritte des normalen Bestellwegs, auch die Bestellübersicht mit ihren Zustimmungen. Im Off-Canvas-Warenkorb, auf der Warenkorbseite und auf der Anmeldeseite steht deshalb an der Stelle des Stripe-Knopfs ein Hinweis. ab 4.10.0

Der Kunde bestellt dann über den normalen Bestellweg. Diese sechs Gründe lösen den Hinweis aus:

• Grund entfällt: Meldet sich der Kunde mit seinem Kundenkonto an, entfällt „Download ohne Konto“. Lädt er die Pflicht-Datei hoch, entfällt „Datei-Upload“. Der Knopf erscheint wieder, sobald kein Grund mehr vorliegt.
• Personalisierte Ware: Sie löst den Hinweis nicht aus.
• Prüfung im Shop: Der Shop entscheidet, bevor er weiß, welche Wallets das Gerät anbietet. Der Hinweis erscheint deshalb auch dort, wo das Gerät gar kein Wallet anbieten würde.
• Warenkorb nachträglich geändert: Wird der Warenkorb erst nach dem Laden des Knopfs prüfpflichtig, lehnt der Shop die Zahlung vor dem Einzug ab und zeigt den Hinweis oben auf der Warenkorbseite.
• Andere Express-Knöpfe: Amazon Pay und PayPal Checkout bleiben, weil sie in die Bestellübersicht zurückführen.

Knopf fehlt ohne Hinweis

In diesen Fällen bleibt die Stelle des Stripe-Knopfs leer:

• Modul: „Bezahlung per Stripe“ ist aus, kein „Öffentlicher Schlüssel“ ist eingetragen, oder „Stripe-Checkout (Expresskauf) erlauben“ ist aus.
• Versand und Zahlung: Stripe ist nicht für „Versandkostenfrei“ freigegeben oder nicht für die Versandart, die im Warenkorb gewählt ist (ohne Wahl die günstigste).
• Zahlart nicht erlaubt: Für die Kundengruppe oder den einzelnen Kunden ist Stripe nicht als Zahlart erlaubt.
• Mindestbestellwert: Der „Mindestbestellwert“ unter Einstellungen → Allgemein → Mindestwerte ist nicht erreicht.
• Warenbestand: „Warenbestand überprüfen“ unter Einstellungen → Checkout → Warenbestand ist eingeschaltet, und ein Artikel ist nicht lieferbar.
• Merkmale: Eine Merkmalskombination im Warenkorb ist nicht bestellbar.
• Betrag: Die Summe des Warenkorbs ist 0.
• Gerät: Stripe bietet auf dem Gerät keine der freigegebenen Zahlarten an.

Sind beide Schalter eingeschaltet, lautet er:

Welche Teile er nennt, folgt aus zwei Schaltern unter Einstellungen → Checkout → Allgemein. Der Satz zur Zahlungspflicht und der Link zur Datenschutzerklärung stehen immer da.

Wohin die Links führen

• AGB: auf die „Alternative AGB PDF Datei“, wenn sie im Ordner files/ liegt, sonst auf die CMS-Seite der AGB, ab Werk „Allgemeine Geschäftsbedingungen“.
• Widerrufsbelehrung: auf die „Alternative Widerruf PDF Datei“, sonst auf die CMS-Seite „Widerrufsrecht“.
• Datenschutzerklärung: immer auf die CMS-Seite „Datenschutz“.

Es sind dieselben Ziele wie in der Bestellübersicht, und alle Links öffnen in einem neuen Tab. Die beiden PDF-Dateien stellen Sie unter Einstellungen → Allgemein → Grundeinstellungen ein.

• Sichtbarkeit: Der Rechtshinweis erscheint erst, wenn Stripe auf dem Gerät mindestens eine Zahlart anbietet. Wo der Hinweis zur Prüfpflicht den Knopf ersetzt, fehlt er.
• Eigener Wortlaut: Unter Tools → xoLanguage können Sie den Text mit einem eigenen Wert überschreiben (TEXT_EXPRESS_CHECKOUT_LEGAL_HINT und die Varianten mit _TERMS, _WITHDRAWAL und _PRIVACY). Die Platzhalter %1$s (AGB), %2$s (Widerrufsbelehrung) und %3$s (Datenschutzerklärung) stehen für die Links und müssen erhalten bleiben. Prüfen Sie den Rechtshinweis nach jeder Änderung unter dem Knopf: Fehlt ein Platzhalter, fehlt der zugehörige Link, und vertauschte Platzhalter verlinken auf die falschen Seiten. Ein Prozentzeichen schreiben Sie als %%, ein einzelnes % kann den Rechtshinweis ausblenden oder verfälschen.

• Kundenkonto statt Gast: Steht „Registrierungspflicht beim Bestellvorgang“ unter Einstellungen → Checkout → Kundendetails auf always_account oder always_account_and_guest_checkbox, legt Express ein Kundenkonto an und schickt die Zugangsdaten per E-Mail. Das gilt nur, wenn zu der E-Mail-Adresse noch kein Kundenkonto besteht.
• Telefonnummer: Das Wallet fragt sie nur ab, wenn „Telefonnummer“ unter Einstellungen → Checkout → Kundendetails auf mandatory steht.

• Versandarten: Wählt der Kunde im Wallet eine Adresse, berechnet der Shop seine Versandarten. Ist der Kunde nicht angemeldet, rechnet er mit PLZ, Ort und Land dieser Adresse, bei angemeldeten Kunden mit der Lieferadresse aus dem Kundenkonto. Angeboten werden nur die Versandarten, für die Stripe unter „Versand und Zahlung“ freigegeben ist, das Wallet zeigt Name und Preis.
• Vorauswahl: Vorausgewählt ist die Versandart aus dem Warenkorb, sonst die erste in der Reihenfolge Ihrer Versandmodule.
• Betrag: Der Shop rechnet wie bei der Buchung mit Versand, Zuschlägen, Rabatten, Gebühren und Steuern. Bei jedem Wechsel der Versandart rechnet er neu.
• Keine passende Versandart: Gibt es für die Adresse keine Versandart oder lässt sich die Summe nicht berechnen, lehnt das Wallet die Adresse ab. Die Meldung dazu kommt vom Wallet, nicht vom Shop.

Abgleich nach der Buchung

Nach dem Anlegen vergleicht der Shop den eingezogenen Betrag mit der Bestellung. Deckt die Zahlung die Bestellung nicht, erhält sie den Status aus „Bestellstatus (Asynchron bezahlt)“ bzw. ohne diese Einstellung Ihren Standardstatus statt des Status aus „Bestellstatus (Sofort bezahlt)“, dazu einen internen Vermerk.

Weicht der Betrag um mehr als 1 Cent ab oder enthält die Bestellung keine Artikel, schickt der Shop zusätzlich eine Mail an Sie, siehe Betreiber-Mail. ab 4.10.0

Abholung (Click & Collect)

• Filiale wählen: Steht im Modul „Click & Collect“ die „Filialauswahl“ auf required, bietet das Wallet keine Abholung an, solange der Kunde nicht vorher im Shop eine Filiale gewählt hat. ab 4.10.0
• Zahlarten der Filiale: Hat eine Filiale eigene Zahlarten ohne Stripe, entfällt die Abholung im Wallet ebenfalls.

Versandarten richten Sie unter Einstellungen → Checkout → Versandarten ein, mehr dazu im Leitfaden Versand & Lieferung.

Unklar ist der Zahlstatus in diesen Fällen:

• Stripe meldet die Zahlung als in Bearbeitung oder nur als reserviert.
• Der Status lässt sich gerade nicht prüfen, etwa bei einer Netzstörung oder einer Störung bei Stripe.
• Der Bestellabschluss bricht ab, nachdem das Geld schon geflossen ist.
• Zur Zahlung ist Geld geflossen, ohne dass eine Bestellung entstand, etwa nach einer Weiterleitung zu PayPal oder Amazon Pay oder bei geschlossenem Tab.

Was der Kunde sieht

Nach einem Abbruch im Zahlungsfenster landet der Kunde auf der Warenkorbseite. Oben steht eine dieser Meldungen:

Nach einer Weiterleitung zu PayPal oder Amazon Pay kommt der Kunde nicht auf die Warenkorbseite zurück. Angemeldete Kunden sehen die passende Meldung auf der Seite „Zahlungsinformationen“, Gäste landen ohne Meldung auf der Anmeldeseite. Bei ihnen erscheint die Meldung, sobald sie erneut mit Stripe bezahlen wollen.

Wie die Sperre wirkt

• Keine zweite Stripe-Zahlung: Einen neuen Express-Versuch lehnt der Shop vor dem Einzug ab. Der normale Bestellweg mit Stripe führt statt zur Bezahlseite von Stripe mit der Meldung zurück in den Warenkorb.
• Geprüfte Zahlung: Ist eine Express-Zahlung bezahlt und geprüft, aber noch nicht gebucht, führt ein neuer Versuch direkt zum Bestellabschluss statt zu einer zweiten Zahlung.
• Ende der Sperre: Die Sperre endet, wenn Stripe die Zahlung als nicht bezahlt meldet, wenn es zur Zahlung eine Bestellung gibt oder spätestens nach 24 Stunden.
• Reichweite: Die Sperre gilt für Stripe in der Sitzung des Kunden. Andere Zahlarten und andere Geräte sperrt sie nicht.

1. Meldung: Stripe meldet eine erfolgreiche Zahlung, zu der der Shop keine Bestellung hat. Der Shop merkt sich die Meldung.
2. Wartezeit: Die Bestellung entsteht frühestens nach der Zeit aus „Bestellrestaurierung – Verzögerung (Minuten)“. Vorgabe sind 30 Minuten, erlaubt sind 5 bis 180. Die Wartezeit verhindert eine doppelte Bestellung, wenn der Kunde gleich zurückkehrt.
3. Auslöser: Gemerkte Meldungen arbeitet der Shop ab, wenn der nächste Webhook von Stripe eintrifft. In ruhigen Zeiten kann es deshalb deutlich länger dauern als die eingestellte Wartezeit.
4. Bestellung: Grundlage ist der Warenkorb-Schnappschuss. Beim Bezahlen speichert der Shop darin Inhalt und Summen des Warenkorbs.

Eine spätere Zahlungsbestätigung von Stripe setzt eine Stripe-Bestellung nur dann auf den Status aus „Bestellstatus (Sofort bezahlt)“, wenn Stripe den Einzug bestätigt und der Betrag die gebuchte Summe deckt. Eine unterdeckte Bestellung behält ihren Status.

Was Sie in der Bestellung sehen

• Interner Hinweis: Jede wiederhergestellte Bestellung trägt im Verlauf einen Hinweis, den der Kunde nicht sieht. Er beginnt mit „Diese Bestellung wurde automatisch vom XONIC Shopsystem restauriert“ und bittet Sie, die Bestellung auf Richtigkeit und Dubletten zu prüfen, bevor Sie dem Kunden eine Bestellbestätigung senden.
• Keine Bestellbestätigung: Die Wiederherstellung schickt dem Kunden keine Bestellbestätigung, er hat vom Shop also noch nichts erhalten. Nach Ihrer Prüfung senden Sie sie zeitnah selbst.

Was Sie tun

1. Abgleichen: Bei Bestellungen mit Vermerk Betrag, Artikel, Erstattung und Anfechtung mit der Zahlung im Stripe-Dashboard vergleichen.
2. Dubletten prüfen: Gibt es zum selben Warenkorb schon eine reguläre Bestellung, prüfen Sie im Stripe-Dashboard, ob zwei Zahlungen eingegangen sind. Nur dann ist die wiederhergestellte eine Dublette. Setzen Sie sie auf einen Storno-Status; mit eingeschalteter „Automatische Rückbuchung“ im Stripe-Modul erstattet der Shop dabei ihre Zahlung.
3. Ergänzen: Fehlende Artikel im Bestelleditor nachtragen, siehe Bestellungen bearbeiten.
4. Abschließen: Erst dann den Status setzen und die Bestellbestätigung senden: im Bestelleditor „Bestellbestätigung versenden“ einschalten und „Aktualisieren“ klicken.

• Was entfällt: Die Einstellung wählte zwischen legacy, dem älteren Payment Request Button von Stripe, und new, dem Express Checkout Element.
• Was das Update tut: Es stellt die Einstellung selbst auf new, auch dort, wo einzelne Domains im Multishop einen eigenen Wert haben. An der Einstellung selbst müssen Sie nichts ändern.
• Shops mit legacy: Sie zeigen nach dem Update das Express Checkout Element, ebenso ältere Installationen ohne diese Einstellung. Je nach Auswahl im Stripe-Modul erscheinen neben Apple Pay und Google Pay auch Link, PayPal und Amazon Pay.
• PayPal und Amazon Pay: Lief Ihr Shop mit legacy und steht in der Tabelle „Zahlungsweisen“ eine Zeile mit „PayPal“, „AmazonPay“ oder „Alle Zahlungsarten“, etwa für die Bezahlseite von Stripe, erscheinen diese Zahlarten nach dem Update erstmals im Express-Knopf. Eine eigene Auswahl nur für den Express-Knopf gibt es nicht. Testen Sie diese Zahlarten nach dem Update, siehe Stolperfallen.
• Eigene Templates: Sie brauchen keine Anpassung.