Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellenAnmelden
ÜbersichtAktualisieren Sie Ihre Integration
Online-Zahlungen
ÜbersichtIhren Use case findenVerwenden Sie Managed Payments
Präsenzzahlungen
Zahlungsmethoden
Zahlungsszenarien
Mehr als Zahlungen

OXXO-Zahlung annehmen

So akzeptieren Sie Zahlungen per OXXO, einer gängigen Zahlungsmethode in Mexiko.

Vorsicht

Stripe kann Ihren Kundinnen und Kunden automatisch die relevanten Zahlungsmethoden anzeigen, indem Währungen, Einschränkungen der Zahlungsmethode und andere Parameter ausgewertet werden.

  • Befolgen Sie den Leitfaden Eine Zahlung akzeptieren, um eine Checkout-Integration zu erstellen, die dynamische Zahlungsmethoden verwendet.
  • Wenn Sie keine dynamischen Zahlungsmethoden verwenden möchten, befolgen Sie die folgenden Schritte, um die Zahlungsmethoden in Ihrer Checkout-Integration manuell zu konfigurieren.

Bei OXXO handelt es sich um eine Zahlungsmethode für die einmalige Nutzung, bei der Kundinnen/Kunden zusätzliche Schritte ausführen müssen, damit eine Zahlung abgeschlossen werden kann. Die Kundinnen/Kunden 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 der gleichen Währung angegeben werden. 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

Hinweis

Erstellen Sie zunächst eine Integration, um mit Checkout Zahlungen anzunehmen, bevor Sie mit diesem Leitfaden fortfahren.

Das führt Sie durch die Aktivierung von OXXO und zeigt die Unterschiede zwischen dem Akzeptieren von Zahlungen mit dynamischen Zahlungsmethoden und dem manuellen Konfigurieren von Zahlungsmethoden.

OXXO als Zahlungsmethode aktivieren

Führen Sie bei der Erstellung einer neuen Checkout-Sitzung folgende Schritte aus:

  1. Fügen Sie oxxo zur Liste der payment_method_types hinzu.
  2. Stellen Sie sicher, dass alle line_items die Währung mxn verwenden.
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=mxn \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=oxxo \
  --data-urlencode success_url="https://example.com/success"

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.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=mxn \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_method_options[oxxo][expires_after_days]"=2 \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=oxxo \
  --data-urlencode success_url="https://example.com/success"

An die von Stripe gehostete Gutscheinseite weiterleiten

Nach dem erfolgreichen Absenden des Checkout-Formulars werden die Kundinnen/Kunden 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 Ausführung der Bestellung vorzunehmen. Erfahren Sie mehr zum Einrichten von Webhooks und Ausführen von Bestellungen.

Die folgenden Ereignisse werden gesendet, wenn sich der Zahlungsstatus ändert:

EreignisnameBeschreibungNächste Schritte

checkout.session.completed

Die Kund/innen haben das Checkout-Formular erfolgreich abgesendet. Stripe hat den OXXO-Gutschein generiert.

Sie können die hosted_voucher_url per E-Mail an die Kund/innen senden, falls sie den OXXO-Gutschein verloren haben.

Warten Sie, bis die Kundin/der Kunde den OXXO-Gutschein bezahlt hat.

checkout.session.async_payment_succeededDie 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_failedDer 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 Kunden/die Kundin per E-Mail und fordern Sie eine neue Bestellung von ihm/ihr an.

Integration testen

Wählen Sie beim Testen Ihrer Checkout-Integration „OXXO“ als Zahlungsmethode aus und klicken Sie auf Bezahlen.

E-Mail-AdresseBeschreibung

{any_prefix}@{any_domain}

Simuliert einen OXXO-Gutschein, bei dem Kund/innen nach 3 Minuten bezahlen und der Webhook payment_intent.succeeded nach etwa 3 Minuten eingeht. Im Live-Betrieb geht dieser Webhook nach 1 Werktag ein.

Beispiel: fulano@test.com

{any_prefix}succeed_immediately@{any_domain}

Simuliert einen OXXO-Gutschein, bei dem Kund/innen sofort bezahlen und der Webhook payment_intent.succeeded nach wenigen Sekunden eingeht. Im Live-Betrieb geht dieser Webhook nach 1 Werktag ein.

Beispiel: succeed_immediately@test.com

{any_prefix}expire_immediately@{any_domain}

Simuliert einen OXXO-Gutschein, der abläuft, bevor Kund/innen bezahlen, und bei dem der Webhook payment_intent.payment_failed nach wenigen Sekunden eingeht.

Das Feld expires_after in next_action.oxxo_display_details wird unabhängig davon, auf was der Parameter expires_after_days in den Optionen für Zahlungsmethoden gesetzt ist, auf die aktuelle Zeit festgelegt.

Beispiel: expire_immediately@test.com

{any_prefix}expire_with_delay@{any_domain}

Simuliert einen OXXO-Gutschein, der abläuft, bevor Kund/innen zahlen, und bei dem der Webhook payment_intent.payment_failed nach ca. 3 Minuten eingeht.

Das Feld expires_after in next_action.oxxo_display_details wird unabhängig davon, auf was der Parameter expires_after_days in den Optionen für Zahlungsmethoden gesetzt ist, auf 3 Minuten festgelegt.

Beispiel: expire_with_delay@test.com

{any_prefix}fill_never@{any_domain}

Simuliert einen OXXO-Gutschein, der abläuft, bevor Kund/innen bezahlen, und bei dem der Webhook payment_intent.payment_failed nach 1 Werktag und 2 Kalendertagen eingeht. Im Live-Betrieb geht dieser Webhook zur gleichen Zeit ein wie im Test-Modus.

Beispiel: fill_never@test.com

OptionalZahlungsanweisungen per E-Mail senden

Sie können E-Mails mit OXXO-Zahlungsanweisungen auf der Seite E-Mail-Einstellungen im Dashboard aktivieren. Nach der Aktivierung sendet Stripe E-Mails mit Zahlungsanweisungen, nachdem der PaymentIntent bestätigt wurde. Die E-Mails enthalten die OXXO-Nummer und einen Link zu der von Stripe gehosteten Gutscheinseite.

Hinweis

In Testumgebungen werden E-Mails mit Anweisungen nur an E-Mail-Adressen gesendet, die mit dem Stripe-Konto verknüpft sind.

Siehe auch