Weiter zum Inhalt
Konto erstellen
oder
anmelden
Das Logo der Stripe-Dokumentation
/
KI fragen
Konto erstellen
Anmelden
Jetzt starten
Zahlungen
Umsatz
Plattformen und Marktplätze
Geldmanagement
Entwicklerressourcen
Übersicht
Informationen zu Stripe Payments
Aktualisieren Sie Ihre Integration
Zahlungsanalysefunktionen
Online-Zahlungen
ÜbersichtIhren Use case findenZahlungen verwalten
Payment Links verwenden
Bezahlseite erstellen
Erweiterte Integration erstellen
In-App-Integration erstellen
Zahlungsmethoden
Zahlungsmethoden hinzufügen
    Übersicht
    Optionen für die Integration von Zahlungsmethoden
    Standardzahlungsmethoden im Dashboard verwalten
    Arten von Zahlungsmethoden
    Karten
    Mit Stripe-Guthaben bezahlen
    Krypto
    Lastschriften
    Bank Redirect
    Banküberweisungen
    Überweisungen (Sources)
    Jetzt kaufen, später bezahlen
    Zahlungen in Echtzeit
    Gutscheine
      Boleto
      Konbini
      Multibanco
        Zahlung annehmen
      OXXO
    Geldbörsen
    Lokale Zahlungsmethoden nach Land aktivieren
    Nutzerdefinierte Zahlungsmethoden
Zahlungsmethoden verwalten
Schnellerer Bezahlvorgang mit Link
Zahlungsschnittstellen
Payment Links
Checkout
Web Elements
In-App-Elements
Zahlungsszenarien
Umgang mit mehreren Währungen
Nutzerdefinierte Zahlungsabläufe
Flexibles Acquiring
Orchestrierung
Präsenzzahlungen
Terminal
Mehr als Zahlungen
Unternehmensgründung
Krypto
Financial Connections
Climate
StartseiteZahlungenAdd payment methodsVouchersMultibanco

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

Unterstützte Unternehmensstandorte: Europe, US

Unterstützte Währungen: eur

Transaktionswährungen: eur

Zahlungsmodus: Yes

Einrichtungsmodus: No

Abonnementmodus: No

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:

  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.
Ruby
Stripe::Checkout::Session.create({ mode: 'payment', payment_method_types: ['card'], payment_method_types: ['card', 'multibanco'], line_items: [{ price_data: { currency: 'usd', # To accept `multibanco`, all line items must have currency: eur currency: 'eur', product_data: { name: 'T-shirt', }, unit_amount: 2000, }, quantity: 1, }], success_url: 'https://example.com/success', cancel_url: 'https://example.com/cancel', })

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_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

OptionalErscheinungsbild des Gutscheins anpassen

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.

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_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

  • Checkout-Ausführung
  • Checkout anpassen
War diese Seite hilfreich?
JaNein
  • Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
  • Nehmen Sie an unserem Programm für frühzeitigen Zugriff teil.
  • Schauen Sie sich unser Änderungsprotokoll an.
  • Fragen? Sales-Team kontaktieren.
  • LLM? Lesen Sie llms.txt.
  • Unterstützt von Markdoc