Boleto-Zahlungen

Für die Unterstützung von Zahlungen per Boleto 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 Boleto aktivieren. Er zeigt die Unterschiede zwischen der Annahme einer Kartenzahlung und der Verwendung von Boleto.

Boleto als Zahlungsmethode aktivieren

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

1. Fügen Sie boleto der Liste der payment_method_types hinzu.
2. Stellen Sie sicher, dass für alle line_items die Währung brl verwendet wird.

Stripe::Checkout::Session.create({
  mode: 'payment',
  payment_method_types: ['card'],
  payment_method_types: ['card', 'boleto'],
  # The parameter is optional. The default value of expires_after_days is 3.
  payment_method_options: {
    boleto: {
      expires_after_days: 7
    }
  },
  line_items: [{
    price_data: {
      # To accept `boleto`, all line items must have currency: brl
      currency: 'brl',
      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 Boleto-Gutscheins in Kalendertagen anzugeben. Wenn Sie beispielsweise einen Boleto-Gutschein am Montag erstellen und expires_after_days auf 2 setzen, läuft der OXXO-Gutschein am Mittwoch um 23:59 Uhr amerikanischer/brasilianischer Zeit (UTC-3) ab. Wenn Sie ihn auf 0 setzen, läuft der Boleto-Gutschein am Ende des Tages ab. Der Parameter expires_after_days kann Werte zwischen 0 und 60 Tagen aufweisen. Der Standardwert ist 3 Tage. Sie können die standardmäßigen Ablauftage für Ihr Konto in den Einstellungen für Zahlungsmethoden anpassen.

An die von Stripe gehostete Gutscheinseite weiterleiten

Nach dem erfolgreichen Absenden des Checkout-Formulars werden die Kund/innen zur hosted_voucher_url weitergeleitet. Die Kund/innen können die Boleto-Nummer kopieren oder den Gutschein im PDF-Format von der gehosteten Gutscheinseite herunterladen.

Stripe sendet ein payment_intent.requires_action-Ereignis, wenn ein Boleto-Gutschein erfolgreich erstellt wurde. Wenn Sie Ihren Kund/innen den Link für den Gutschein per E-Mail senden müssen, können Sie die hosted_voucher_url in payment_intent.next_action.boleto_display_details ermitteln. Erfahren Sie mehr darüber, wie Sie einen PaymentIntent mit Webhooks überwachen.

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 „Nummer kopieren“
• Markenfarbe – Die Hintergrundfarbe

Ihre Bestellungen ausführen

Da Boleto 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 der Abwicklung von Bestellungen.

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

Wählen Sie beim Testen Ihrer Checkout-Integration Boleto als Zahlungsmethode aus und klicken Sie auf die Schaltfläche Bezahlen.

Boleto-Zahlungen können nicht zurückerstattet werden. Einige Händler bieten aber separate Möglichkeiten für Gutschriften, falls sich die Kund/innen diesbezüglich an sie wenden sollten.

Boleto-Zahlungen können von den Kund/innen nicht angefochten werden.