OXXO-Zahlung annehmen
Vorsicht
Stripe passt die den Kund/innen angezeigten Zahlungsmethoden automatisch an Währung, geltende Einschränkungen und andere Parameter an. Wir empfehlen Ihnen, Ihre Zahlungsmethoden im Dashboard zu konfigurieren und sich dabei an dem Artikel Zahlungen annehmen zu orientieren.
Wenn Sie weiterhin manuell einstellen möchten, welche Zahlungsmethoden im Bezahlvorgang angezeigt werden, können Sie sich an diesem Leitfaden orientieren (etwa für die Zahlungsannahme im Subscription mode). Ansonsten empfehlen wir unseren Artikel Zahlungsmethoden zum Dashboard migrieren.
Bei OXXO handelt es sich um eine Zahlungsmethode für die einmalige Nutzung, bei der Kund/innen zusätzliche Schritte ausführen müssen, damit eine Zahlung abgeschlossen werden kann. Die Kund/innen zahlen mit einem OXXO-Gutschein, der eine generierte Nummer aufweist, in einem OXXO Convenience Store in bar.
Kompatibilität bestimmen
Für die Unterstützung von OXXO-Zahlungen muss eine Checkout-Sitzung alle folgenden Bedingungen erfüllen:
- Die Preise sämtlicher Posten müssen in derselben Währung vorliegen. Falls Posten in verschiedenen Währungen vorhanden sind, muss für jede Währung eine separate Checkout-Sitzung erstellt werden.
- Sie können nur einmalige Posten verwenden (wiederkehrende Abonnementpläne werden nicht unterstützt).
Zahlung annehmen
Notiz
Erstellen Sie eine Integration, um mit Checkout Zahlungen anzunehmen, bevor Sie diesen Leitfaden verwenden.
In diesem Leitfaden erfahren Sie, wie Sie OXXO aktivieren. Er zeigt die Unterschiede zwischen der Annahme einer Kartenzahlung und der Verwendung von OXXO.
OXXO als Zahlungsmethode aktivieren
Führen Sie bei der Erstellung einer neuen Checkout-Sitzung folgende Schritte aus:
- Fügen Sie
oxxo
zur Liste derpayment_method_types
hinzu. - Stellen Sie sicher, dass alle
line_items
die Währungmxn
verwenden.
Zusätzliche Optionen für Zahlungsmethoden
Sie können für Ihre Session
den optionalen Parameter expires_after_days
in den Optionen für Zahlungsmethoden nutzen, um die Gültigkeit eines OXXO-Gutscheins in Kalendertagen anzugeben. Wenn Sie beispielsweise einen OXXO-Gutschein am Montag erstellen und expires_after_days
auf 2 setzen, läuft der OXXO-Gutschein am Mittwoch um 23:59 Uhr amerikanischer/mexikanischer Zeit (UTC-6) ab. Der Parameter expires_after_days
kann Werte zwischen 1 und 7 aufweisen. Der Standardwert ist 3 Tage.
An die von Stripe gehostete Gutscheinseite weiterleiten
Nach dem erfolgreichen Absenden des Checkout-Formulars werden die Kund/innen zur hosted_voucher_url
weitergeleitet. Über die gehostete Gutscheinseite können sie den Barcode finden oder den OXXO-Gutschein ausdrucken. Die hosted_voucher_url
befindet sich in payment_intent.next_action.oxxo_display_details.
Auf der Seite mit den Branding-Einstellungen können Sie die Nutzeroberfläche für Ihre Kund/innen anpassen. Folgende Anpassungen sind für Gutscheine möglich:
- Symbol – Ihr Markenlogo und Ihr offizieller Firmenname
- Akzentfarbe — Farbe für die Schaltfläche „Drucken“
- Markenfarbe – Die Hintergrundfarbe
Wickeln Sie Ihre Bestellungen ab
Da OXXO eine Zahlungsmethode mit verzögerter Benachrichtigung ist, müssen Sie eine Methode wie Webhooks nutzen, um den Zahlungsstatus zu überwachen und die Bestellung Ausführung vorzunehmen. Erfahren Sie mehr zum Einrichten von Webhooks und Abwickeln von Bestellungen.
Die folgenden Ereignisse werden gesendet, wenn sich der Zahlungsstatus ändert:
Ereignisname | Beschreibung | Nächste Schritte |
---|---|---|
Die Kund/innen haben das Checkout-Formular erfolgreich abgesendet. Stripe hat den OXXO-Gutschein generiert. Sie können die | Warten Sie, bis die Kundin/der Kunde den OXXO-Gutschein bezahlt hat. | |
checkout.session.async_payment_succeeded | Die Kundin/der Kunde hat den OXXO-Gutschein erfolgreich bezahlt. Der PaymentIntent geht in den Status succeeded über. | Wickeln Sie die Kundenbestellung ab. |
checkout.session.async_payment_failed | Der OXXO-Gutschein ist abgelaufen oder die Zahlung ist aus einem anderen Grund fehlgeschlagen. Der PaymentIntent kehrt zum Status requires_payment_method zurück. | Kontaktieren Sie den/die Kund/in per E-Mail und fordern Sie eine neue Bestellung an. |
Integration testen
Wählen Sie beim Testen Ihrer Checkout-Integration „OXXO“ als Zahlungsmethode aus und klicken Sie auf Bezahlen.
E-Mail-Adresse | Beschreibung |
---|---|
| Simuliert einen OXXO-Gutschein, bei dem Kund/innen nach 3 Minuten bezahlen und der Webhook Beispiel: fulano@test.com |
| Simuliert einen OXXO-Gutschein, bei dem Kund/innen sofort bezahlen und der Webhook Beispiel: succeed_immediately@test.com |
| Simuliert einen OXXO-Gutschein, der abläuft, bevor Kund/innen bezahlen, und bei dem der Webhook Das Feld Beispiel: expire_immediately@test.com |
| Simuliert einen OXXO-Gutschein, der abläuft, bevor Kund/innen zahlen, und bei dem der Webhook Das Feld Beispiel: expire_with_delay@test.com |
| Simuliert einen OXXO-Gutschein, der abläuft, bevor Kund/innen bezahlen, und bei dem der Webhook Beispiel: fill_never@test.com |