OXXO-Zahlung annehmen

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).

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:

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.

Stripe::Checkout::Session.create({
  mode: 'payment',
  payment_method_types: ['card'],
  payment_method_types: ['card', 'oxxo'],
  # The parameter is optional. The default value of expires_after_days is 3.
  payment_method_options: {
    oxxo: {
      expires_after_days: 2
    }
  },
  line_items: [{
    price_data: {
      # To accept `oxxo`, all line items must have currency: mxn
      currency: 'mxn',
      product_data: {
        name: 'T-shirt',
      },
      unit_amount: 2000,
    },
    quantity: 1,
  }],
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

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 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:

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