Boleto-Zahlungen

Eine Checkout Session muss die folgende Bedingung erfüllen, um Boleto-Zahlungen zu unterstützen:

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

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

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.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=brl \
  -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]"=boleto \
  --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 Boleto-Gutscheins in Kalendertagen anzugeben. Wenn Sie beispielsweise einen Boleto-Gutschein am Montag erstellen und expires_after_days auf 2 setzen, läuft der Boleto-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.Sie können die Standard-Ablaufdaten für Ihr Konto in den Einstellungen für Zahlungsmethoden anpassen.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=brl \
  -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[boleto][expires_after_days]"=7 \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=boleto \
  --data-urlencode success_url="https://example.com/success"

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.