Boleto-Zahlungen
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 Boleto 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 Boleto-Gutschein mit einer generierten Nummer an Geldautomaten, bei Banken, Bankportalen oder autorisierten Agenturen.
Kompatibilität bestimmen
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).
Zahlung annehmen
Notiz
Erstellen Sie eine Integration, um mit Checkout Zahlungen anzunehmen, bevor Sie diesen Leitfaden verwenden.
Use this guide to learn how to enable Boleto—it shows the differences between accepting a card payment and using Boleto.
Boleto als Zahlungsmethode aktivieren
Führen Sie beim Erstellen einer neuen Checkout-Sitzung folgende Schritte aus:
- Fügen Sie
boleto
der Liste derpayment_method_types
hinzu. - Stellen Sie sicher, dass für alle
line_items
die Währungbrl
verwendet wird.
Zusätzliche Optionen für Zahlungsmethoden
You can specify an optional expires_after_days
parameter in the payment method options for your Session
that sets the number of calendar days before a Boleto voucher expires. For example, if you create a Boleto voucher on Monday and you set expires_after_days
to 2, the Boleto voucher expires on Wednesday at 23:59 America/Sao_Paulo (UTC-3) time. If you set it to 0, the Boleto voucher expires at the end of the day. The expires_after_days
parameter can be set from 0 to 60 days. The default is 3 days. You can customize the default expiration days on your account in the Payment methods settings
An die von Stripe gehostete Gutscheinseite weiterleiten
Notiz
Anders als bei Kartenzahlungen werden die Kund/innen bei Boleto-Zahlungen nicht zur success_url weitergeleitet.
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 übermittelt 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 zusenden möchten, finden Sie die hosted_voucher_url
in payment_intent.next_action.boleto_display_details. Erfahren Sie mehr darüber, wie Sie eine 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 Unternehmensname
- Akzentfarbe: Farbe für die Schaltfläche „Nummer kopieren“
- Markenfarbe: 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 über das Einrichten von Webhooks und Ausführen von Bestellungen.
Die folgenden Ereignisse werden gesendet, wenn sich der Zahlungsstatus ändert:
Ereignisname | Beschreibung | Nächste Schritte |
---|---|---|
Der/die Kund/in hat das Bezahlformular erfolgreich übermittelt. Stripe hat den Boleto-Gutschein generiert. Sie können festlegen, dass die | Warten Sie, bis der/die Kund/in per Boleto bezahlt hat. | |
checkout.session.async_payment_succeeded | Der/die Kund/in hat erfolgreich per Boleto bezahlt. Der PaymentIntent geht in den Status succeeded über. | Führen Sie die Bestellung der Waren oder Dienstleistungen aus, die der/die Kund/in gekauft hat. |
checkout.session.async_payment_failed | Der Boleto-Gutschein ist abgelaufen, oder die Zahlung ist aus einem anderen Grund fehlgeschlagen. Der PaymentIntent wechselt wieder in den Status requires_payment_method . | 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 Boleto als Zahlungsmethode aus und klicken Sie auf die Schaltfläche Bezahlen.
Beschreibung | |
---|---|
| Simuliert einen Boleto-Gutschein, bei dem Kund/innen nach 3 Minuten bezahlen und der Webhook Beispiel: fulaninho@beispiel.com |
| Simuliert einen Boleto-Gutschein, bei dem Kund/innen sofort bezahlen und der Webhook Beispiel: succeed_immediately@beispiel.com |
| Simuliert einen Boleto-Gutschein, der abläuft, bevor Kund/innen bezahlen, und bei dem der Webhook Das Feld Beispiel: expire_immediately@beispiel.com |
| Simuliert einen Boleto-Gutschein, der abläuft, bevor Kund/innen zahlen, und bei dem der Webhook Das Feld Beispiel: expire_with_delay@beispiel.com |
| Simuliert einen Boleto-Gutschein, der nie erfolgreich ist. Er läuft entsprechend der Angabe im Feld Beispiel: fill_never@beispiel.com |
Steueridentifikationsnummer | Beschreibung |
---|---|
CPF CNPJ | Setzen Sie im Testmodus |
Handhabung von Rückerstattungen
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.
Handhabung von Zahlungsanfechtungen
Boleto-Zahlungen können von den Kund/innen nicht angefochten werden.