Multibanco-Zahlungen annehmen
So akzeptieren Sie Zahlungen per Multibanco.
Vorsicht
Stripe passt die den Kundinnen/Kunden angezeigten Zahlungsmethoden automatisch an Währung, geltende Einschränkungen und andere Parameter an. Wir empfehlen Ihnen, Ihre Zahlungsmethoden im Stripe-Dashboard zu konfigurieren und sich dabei an dem Artikel Zahlungen annehmen zu orientieren.
Wenn Sie weiterhin manuell konfigurieren möchten, welche Zahlungsmethoden Ihren Kundinnen/Kunden mit Checkout angezeigt werden sollen, können Sie sich an diesem Leitfaden orientieren. Andernfalls migrieren Sie zum Dashboard.
Multibanco ist eine auf Gutscheinen basierende Zahlungsmethode in Portugal. Wenn Ihr Unternehmen in Europa oder den Vereinigten Staaten ansässig ist, können Sie Multibanco-Zahlungen von Kunden/Kundinnen in Portugal über die Payment Intents API akzeptieren.
Zur Abwicklung einer Transaktion erhalten die Kunden/Kundinnen einen Gutschein, der die Multibanco-Einheit und die Referenznummern enthält. Mithilfe dieser Gutscheindaten kann eine Zahlung außerhalb des Bezahlvorgangs über das Online-Banking oder einen Geldautomaten getätigt werden.
Die Zahlungsbestätigung kann sich aufgrund der Einleitung einer Banküberweisung um mehrere Tage verzögern, wenn ein Kunde/eine Kundin für einen Multibanco-Gutschein bezahlt. Banküberweisungen können insbesondere am Wochenende zu Verzögerungen führen, was wiederum zu einer Verzögerung der Zahlungsbestätigung beiträgt.
Kompatibilität bestimmen
Für die Unterstützung von Multibanco muss eine Checkout-Sitzung alle folgenden Bedingungen erfüllen:
- Die Preise müssen für alle Posten in der gleichen Währung (EUR) angegeben werden.
- Sie können nur einmalige Posten verwenden (wiederkehrende Abonnementpläne werden nicht unterstützt).
Zahlung akzeptieren
Notiz
Erstellen Sie zunächst eine Integration, um mit Checkout Zahlungen anzunehmen, bevor Sie mit diesem Leitfaden fortfahren.
Aktivieren Sie Multibanco, indem Sie die folgenden Aktualisierungen an Ihrer Kartenzahlungsintegration vornehmen.
Multibanco als Zahlungsmethode aktivieren
Führen Sie bei der Erstellung einer neuen Checkout-Sitzung folgende Schritte aus:
- Fügen Sie
multibanco
zur Liste derpayment_
hinzu.method_ types - Stellen Sie sicher, dass alle
line_
die Währungitems eur
verwenden.
An die von Stripe gehostete Gutscheinseite weiterleiten
Notiz
Anders als bei Kartenzahlungen werden die Kundinnen/Kunden bei einer Multibanco-Zahlung nicht zur success_url weitergeleitet.
Nach der erfolgreichen Übermittlung des Checkout-Formulars werden die Kundinnen/Kunden zur hosted_
weitergeleitet. Dort können sie die Zahlungsanweisungen der gehosteten Seite einsehen, um zu erfahren, wie sie die Zahlung abschließen können. Sie können die Seite sowohl auf Desktop-Plattformen als auch auf mobilen Plattformen anzeigen und sie kann sogar ausgedruckt werden.
Stripe sendet ein payment_intent.requires_action-Ereignis, wenn ein Multibanco-Gutschein erfolgreich erstellt wurde. Wenn Sie eine E-Mail mit dem Link für Zahlungsanweisungen für den Gutschein senden müssen, suchen Sie das PaymentIntent im Ereignis requires_
unter data.
und extrahieren Sie die hosted_
unter next_action.multibanco_display_details.hosted_voucher_url auf dem PaymentIntent.
Bestellungen abwickeln
Da Multibanco 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 durchzuführen. Erfahren Sie mehr zum Einrichten von Webhooks und der Abwicklung von Bestellungen.
Die folgenden Ereignisse werden gesendet, wenn sich der Zahlungsstatus ändert:
Ereignisname | Beschreibung | Nächste Schritte |
---|---|---|
checkout.session.completed | Der Kunde/Die Kundin hat das Bezahlformular erfolgreich übermittelt. Stripe hat einen Multibanco-Gutschein generiert. | Warten Sie, bis die Kundin/der Kunde den Multibanco-Gutschein bezahlt hat. |
checkout.session.async_payment_succeeded | Die Kundin/der Kunde hat den Multibanco-Gutschein erfolgreich bezahlt. Der PaymentIntent geht in den Status succeeded über. | Wickeln Sie die Kundenbestellung ab. |
checkout.session.async_payment_failed | Der Multibanco-Gutschein ist abgelaufen oder die Zahlung ist aus einem anderen Grund fehlgeschlagen. Der PaymentIntent wechselt wieder in den Status requires_ . | 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 Multibanco als Zahlungsmethode aus und klicken Sie dann auf Bezahlen. Geben Sie die folgenden Werte in das Checkout-Formular ein, um verschiedene Szenarien zu testen.
Beschreibung | |
---|---|
| Simuliert einen Multibanco-Gutschein, den ein Kunde/eine Kundin bezahlt. Der Webhook Beispiel: irgendetwas@example.com |
| Simuliert einen Multibanco-Gutschein, den ein Kunde/eine Kundin sofort bezahlt. Der Webhook Beispiel: succeed_immediately@example.com |
| Simuliert einen Multibanco-Gutschein, der sofort abläuft. Der Webhook Beispiel: expire_immediately@example.com |
| Simuliert einen Multibanco-Gutschein, der abläuft, bevor ein Kunde/eine Kundin bezahlt. Der Webhook Beispiel: expire_with_delay@example.com |
| Simuliert einen Multibanco-Gutschein, der nie erfolgreich ist. Der Webhook Beispiel: fill_never@example.com |
Ablaufdatum
Multibanco-Gutscheine laufen am expires_
UNIX-Zeitstempel in next_action.multibanco_display_details.expires_at ab, d. h. 7 Tage, nachdem Sie den Gutschein erstellt haben. Kunden/Kundinnen können einen Multibanco-Gutschein nicht bezahlen, nachdem er abgelaufen ist. Nach Ablauf geht der Status des PaymentIntent von requires_
in processing
über, und Stripe sendet ein payment_intent.processing-Ereignis.
Der PaymentIntent verbleibt für eine Pufferzeit von 4 Tagen im Status processing
, um mögliche abgeschlossene Verzögerungen von Zahlungsbestätigungen aufgrund von Banküberweisungsverzögerungen zu berücksichtigen. Wenn die Multibanco-Zahlung nicht innerhalb der Pufferzeit abgeschlossen wird, wechselt der Status des PaymentIntent zu requires_
und Stripe sendet das Ereignis payment_intent.payment_failed. Wenn Sie die Gelder des Kunden/der Kundin nach der Pufferzeit erhalten, leitet Stripe automatisch den Rückerstattungsprozess für den falsch bezahlten Betrag ein.
Stornierung
Sie können Multibanco-Gutscheine über PaymentIntent stornieren stornieren. Anschließend sendet Stripe ein payment_intent.canceled-Ereignis.
Wenn Gelder eines Kunden/einer Kundin für einen stornierten Multibanco-Gutschein eingehen, leitet Stripe automatisch den Rückerstattungsvorgang für den falsch bezahlten Betrag ein.
Notiz
Wenn Sie eine ausstehende Zahlung stornieren, werden die ursprünglichen Anweisungen für den Gutschein ungültig. Wenn Sie eine ausstehende Multibanco-Zahlung stornieren, informieren Sie Ihre Kundin/Ihren Kunden.
Wenn Sie einen PaymentIntent mit dem Status requires_
erfolgreich erneut bestätigen, erstellet Stripe neue Gutscheinanweisungen und eine neue hosted_
. Sie müssen Ihre Kundinnen/Kunden darüber in Kenntnis setzen.
Rückerstattungen
Erfahren Sie mehr über Multibanco-Rückerstattungen.