Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellenAnmelden
ÜbersichtAktualisieren Sie Ihre Integration
Online-Zahlungen
ÜbersichtIhren Use case findenVerwenden Sie Managed Payments
Präsenzzahlungen
Zahlungsmethoden
Zahlungsszenarien
Mehr als Zahlungen

Multibanco-Zahlungen annehmen

So akzeptieren Sie Zahlungen per Multibanco.

Vorsicht

Stripe kann Ihren Kundinnen und Kunden automatisch die relevanten Zahlungsmethoden anzeigen, indem Währungen, Einschränkungen der Zahlungsmethode und andere Parameter ausgewertet werden.

  • Befolgen Sie den Leitfaden Eine Zahlung akzeptieren, um eine Checkout-Integration zu erstellen, die dynamische Zahlungsmethoden verwendet.
  • Wenn Sie keine dynamischen Zahlungsmethoden verwenden möchten, befolgen Sie die folgenden Schritte, um die Zahlungsmethoden in Ihrer Checkout-Integration manuell zu konfigurieren.

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 Stripe Checkout akzeptieren.

Zur Abwicklung einer Transaktion erhalten die Kundinnen oder Kunden einen Gutschein, der eine Multibanco-Entitäts- und Referenznummer enthält. Mithilfe dieser Gutscheindaten kann die Zahlung außerhalb Ihres Bezahlvorgangs per Online-Banking oder Bankautomat erfolgen.

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

Hinweis

Erstellen Sie zunächst eine Integration, um mit Checkout Zahlungen anzunehmen, bevor Sie mit diesem Leitfaden fortfahren.

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

Multibanco als Zahlungsmethode aktivieren

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

  1. Fügen Sie multibanco zur Liste der payment_method_types hinzu.
  2. Stellen Sie sicher, dass alle line_items die Währung eur verwenden.
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=eur \
  -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]"=multibanco \
  --data-urlencode success_url="https://example.com/success"

An die von Stripe gehostete Gutscheinseite weiterleiten

Hinweis

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_voucher_url 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_action unter data.object und extrahieren Sie die hosted_voucher_url 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:

EreignisnameBeschreibungNächste Schritte
checkout.session.completedDer 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_succeededDie 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_failedDer Multibanco-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 Kunden/die Kundin per E-Mail und fordern Sie eine neue Bestellung von ihm/ihr an.

OptionalAutomatisierte Zahlungsanweisungen per E-Mail senden

Sie können E-Mails mit Multibanco-Zahlungsanweisungen auf der Seite E-Mail-Einstellungen im Dashboard aktivieren. Nach der Aktivierung sendet Stripe E-Mails mit Zahlungsanweisungen, nachdem der PaymentIntent bestätigt wurde. Die E-Mails enthalten die Multibanco-Gutscheinanweisungen und einen Link zu der von Stripe gehosteten Gutscheinseite.

Hinweis

In Testumgebungen werden E-Mails mit Anweisungen nur an E-Mail-Adressen gesendet, die mit dem Stripe-Konto verknüpft sind.

OptionalErscheinungsbild des Gutscheins anpassen

Passen Sie in den Branding-Einstellungen die Nutzeroberfläche für Ihre Kundinnen/Kunden an.

Sie können die folgenden Branding-Einstellungen auf die von Stripe gehostete Gutscheinseite anwenden:

  • Symbol: Ihr Markenlogo und Unternehmensname
  • Logo: Ihr Markenlogo
  • Akzentfarbe: Die Farbe für die Schaltfläche „Drucken“
  • Markenfarbe: Die Hintergrundfarbe

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.

E-MailBeschreibung

{any_prefix}@{any_domain}

Simuliert einen Multibanco-Gutschein, den ein Kunde/eine Kundin bezahlt. Der Webhook payment_intent.succeeded geht nach etwa 3 Minuten ein.

Beispiel: irgendetwas@example.com

{any_prefix}succeed_immediately@{any_domain}

Simuliert einen Multibanco-Gutschein, den ein Kunde/eine Kundin sofort bezahlt. Der Webhook payment_intent.succeeded geht nach wenigen Sekunden ein.

Beispiel: succeed_immediately@example.com

{any_prefix}expire_immediately@{any_domain}

Simuliert einen Multibanco-Gutschein, der sofort abläuft. Der Webhook payment_intent.payment_failed geht innerhalb weniger Sekunden ein.

Beispiel: expire_immediately@example.com

{any_prefix}expire_with_delay@{any_domain}

Simuliert einen Multibanco-Gutschein, der abläuft, bevor ein Kunde/eine Kundin bezahlt. Der Webhook payment_intent.payment_failed geht nach ca. 3 Minuten ein.

Beispiel: expire_with_delay@example.com

{any_prefix}fill_never@{any_domain}

Simuliert einen Multibanco-Gutschein, der nie erfolgreich ist. Der Webhook payment_intent.payment_failed trifft nach 11 Tagen ein und imitiert das Verhalten im Live-Modus. Erfahren Sie mehr über den Ablaufzeitpunkt von Multibanco.

Beispiel: fill_never@example.com

Ablaufdatum

Multibanco-Gutscheine laufen am expires_at 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_action 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_payment_method 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.

Hinweis

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_action erfolgreich erneut bestätigen, erstellet Stripe neue Gutscheinanweisungen und eine neue hosted_voucher_url. Sie müssen Ihre Kundinnen/Kunden darüber in Kenntnis setzen.

Rückerstattungen

Erfahren Sie mehr über Multibanco-Rückerstattungen.

Siehe auch