Multibanco-Zahlungen mit SourcesBeta

Nehmen Sie mit Sources Zahlungen per Multibanco an, der beliebtesten Zahlungsmethode in Portugal.

Achtung

Wir haben die Unterstützung für Sources-API eingestellt und planen außerdem, die Unterstützung für lokale Zahlungsmethoden einzustellen. Wenn Sie derzeit Multibanco mithilfe der Sources API integrieren, müssen Sie eine Migration zur Payment Methods API vornehmen.

Informationen zur Integration von Multibanco mit den aktuellen APIs finden Sie unter Multibanco-Zahlungen.

Stripe-Nutzer/innen in Europa und den Vereinigten Staaten können Multibanco-Zahlungen von Kundinnen/Kunden in Portugal über Sources annehmen. Hierbei handelt es sich um einen zentralen Integrationspfad zum Erstellen von Zahlungen mittels einer beliebigen unterstützten Methode.

Während des Zahlungsvorgangs wird ein Source-Objekt erstellt, und Ihre Kundinnen/Kunden werden entweder an die Multibanco-Website, Ihre Website oder einen Multibanco-Geldautomaten weitergeleitet, um die Gelder zu senden. Nach Abschluss dieses Vorgangs verwendet Ihre Integration die Quelle, um eine Zahlungsanfrage durchzuführen und die Zahlung abzuschließen.

Multibanco ist eine Push-basierte, einmalige und synchrone Zahlungsmethode. Dies bedeutet, dass Ihre Kundin/Ihr Kunde geeignete Maßnahmen ergreift, um Ihnen den Betrag über einen Empfänger zu senden. Das Senden der Gelder per Push-Verfahren kann innerhalb weniger Minuten und spätestens innerhalb von sieben Tagen abgeschlossen werden, da Ihre Kundin/Ihr Kunde dies außerhalb Ihres Bezahlvorgangs durchführen muss. Sobald die Gelder eingegangen sind, kann die Zahlung sofort abgewickelt werden. Bei der Abbuchung gibt es sofort eine Bestätigung über den Erfolg oder Misserfolg der Zahlung.

Source-Objekt erstellen

Ein Source-Objekt wird entweder clientseitig über Stripe.js oder serverseitig über den Endpoint zur Quellenerstellung mit den folgenden Parametern erstellt:

Parameter	Wert
`type`	Multibanco
`amount`	Eine positive ganze Zahl in der kleinsten Währungseinheit, die den Betrag darstellt, der von der Kundin/vom Kunden abgebucht wird (beispielsweise 1099 für eine Zahlung über 10,99 EUR).
`currency`	eur (Multibanco muss immer Euro verwenden)
`redirect[return_url]`	Die URL, an die der/die Kund/in nach dem Autorisierungsvorgang weitergeleitet werden soll.
`owner[email]`	Die vollständige E-Mail-Adresse des/der Kund/in.

Um eine Quelle mit Stripe.js zu erstellen, binden Sie zunächst die Bibliothek in Ihre Website ein und legen Sie dann Ihren veröffentlichbaren API-Schlüssel fest. Sobald Sie die Bibliothek eingebunden haben, verwenden Sie die folgende createSource-Methode, um eine Quelle clientseitig zu erstellen:

stripe.createSource({
  type: 'multibanco',
  amount: 1099,
  currency: 'eur',
  owner: {
    name: 'Jenny Rosen',
    email: 'jenny.rosen@example.com',
  },
  redirect: {
    return_url: '__TOKEN_PLACEHOLDER_0__',
  },
}).then(function(result) {
  // handle result.error or result.source
});

Bei beiden Methoden gibt Stripe ein Source-Objekt zurück, das die relevanten Details für die verwendete Zahlungsmethode enthält. Spezifische Informationen für Multibanco werden im Subhash multibanco zur Verfügung gestellt.

{
  "id": "src_16xhynE8WzK49JbAs9M21jaR",
  "object": "source",
  "amount": 1099,
  "client_secret": "src_client_secret_UfwvW2WHpZ0s3QEn9g5x7waU",
  "created": 1445277809,
  "currency": "eur",
  "flow": "receiver",
  "livemode": true,
  "owner": {

Erstellung einer Quelle in mobilen Anwendungen

Wenn Sie eine iOS- oder Android-App erstellen, können Sie Quellen mit unseren Mobile SDKs implementieren. Weitere Informationen finden Sie in unserer Dokumentation zu Quellen für iOS oder Android.

Kund/innen sollen Gelder senden

Beim Erstellen einer Quelle wird ihr Status zunächst auf pending gesetzt und kann noch nicht für eine Zahlungsanfrage verwendet werden. Um mit Multibanco zu zahlen, müssen Ihre Kund/innen eine Überweisung der Gelder von ihrem Bankkonto unter Verwendung der von Ihnen zur Verfügung gestellten Referenz- und Objektnummern entweder über ihren Computer, ihr Smartphone oder einen Geldautomaten vor Ort veranlassen.

Portugiesische Händler zeigen diese Angaben häufig im Rahmen ihres Bezahlvorgangs an, nachdem die Kund/innen ihren Kauf bestätigt haben. Außerdem werden sie in eine E-Mail zur Bestellbestätigung aufgenommen.

Sie können Ihre Kund/innen auch an eine von Multibanco gehostete Seite weiterleiten, auf der diese Angaben für Sie angezeigt werden, indem Sie die im Attribut redirect[url] des Source-Objekts angegebene URL verwenden. Multibanco leitet sie dann zurück zu der als Wert von redirect[return_url] angegebenen URL, unabhängig davon, ob Gelder gesendet wurden oder nicht.

Wenn die Kund/innen Gelder senden, wechselt der Status des Source-Objekts zu chargeable, sodass Sie die Quelle belasten und die Transaktion abschließen können. Wenn Sie dies nicht tun, ändert sich der Status nach sechs Stunden in canceled.

Stripe füllt die redirect[return_url] mit den folgenden GET-Parametern, wenn Sie Ihre Kund/innen zurück zu Ihrer Website leiten:

source: eine Zeichenfolge, die die ursprüngliche ID des Source-Objekts darstellt
livemode: gibt an, ob es sich um eine Live-Zahlung handelt, der Wert ist entweder true oder false
client_secret: wird verwendet, um zu überprüfen, ob die wiederkehrenden Kund/innen identisch mit denjenigen sind, die die Erstellung der Quelle ausgelöst haben (Quell-IDs werden nicht als geheim betrachtet)

Sie können alle anderen GET-Parameter angeben, die Sie möglicherweise bei der Angabe von redirect[return_url] benötigen. Verwenden Sie die obigen Angaben nicht selbst als Parameternamen, da diese durch die von uns übernommenen Werte überschrieben werden würden.

Mobile Anwendungen

Um Multibanco in eine App zu integrieren, geben Sie als Wert für die redirect[return_url] das URI-Schema Ihrer App an. Dadurch werden Ihre Kundinnen und Kunden nach der Durchführung der Autorisierung an Ihre App zurückgeleitet. Weitere Informationen finden Sie in unserer Sources-Dokumentation für iOS oder Android.

Weiterleitung und Zahlung testen

Wenn Sie ein Source-Objekt mit Ihren Test-API-Schlüsseln erstellen, wird die Testzahlung mit einer Verzögerung von drei Sekunden ausgeführt. Verwenden Sie eine der folgenden Test-E-Mail-Adressen, wenn Sie Multibanco-Zahlungen unter verschiedenen Bedingungen testen müssen.

E-Mail	Beschreibung
`{any_prefix}+fill_never@{any_domain}`	Gelder werden niemals an die Empfängeradresse gesendet.
`{any_prefix}+fill_now@{any_domain}`	Wenn der Empfänger nach der Erstellung das nächste Mal abgerufen wird, hat er den vollständigen Betrag erhalten.

Über die im Feld redirect[url] zurückgegebene URL gelangen Sie zu einer Beispielseite für Zahlungen. Bei Rückkehr von dieser Seite werden Sie zu der im Feld redirect[return_url] angegebenen URL geleitet.

Quelle belasten

Sobald der/die Kund/in die Gelder überwiesen hat, wechselt der status der Quelle zu chargeable, und sie kann für eine Zahlungsanfrage verwendet werden. Dieser Übergang erfolgt asynchron und findet möglicherweise statt, nachdem der/die Kund/in auf Ihre Website zurückgeleitet wurde.

Es kann Minuten, Stunden oder auch Tage dauern, bis ein/e Kund/in die Gelder nach der Weiterleitung und der Rückkehr von der Weiterleitung sendet.

Aus diesem Grund ist es wichtig, dass Ihre Integration auf Webhooks zurückgreift, um festzustellen, wann die Quelle kostenpflichtig wird, um eine Gebühr zu erstellen. In unseren Best Practices finden Sie weitere Einzelheiten zur optimalen Integration von Zahlungsmethoden mit Webhooks.

Webhooks

Die folgenden Webhook-Ereignisse werden übermittelt, um Sie über Änderungen am Status der Quelle zu informieren:

Ereignis	Beschreibung
`source.chargeable`	Ein `Source`-Objekt wechselt in den Status `chargeable`, nachdem ein/e Kund/in eine Zahlung authentifiziert und verifiziert hat.
`source.failed`	Ein `Source`-Objekt wurde nicht abrechenbar, da Ihr/e Kund/in die Authentifizierung der Zahlung abgelehnt hat.
`source.canceled`	Ein `Source`-Objekt ist abgelaufen und kann nicht zum Erstellen einer Zahlung verwendet werden.

Eine Zahlungsanfrage unter Verwendung der Quelle stellen

Sobald die Quelle abrechenbar ist, können Sie von Ihrem Webhook-Handler source.chargeable aus eine Zahlungsanfrage mit der Quell-ID als Wert für den Parameter source stellen, um die Zahlung abzuschließen.

Multibanco-Quellen sind einmalig und können nicht für wiederkehrende oder zusätzliche Zahlungen verwendet werden. Weitere Informationen dazu, wie Quellen zur einmaligen Nutzung mit Kundinnen/Kunden interagieren, finden Sie in unserem Leitfaden zu Quellen und Kundinnen/Kunden.

Bestätigen, dass die Zahlung erfolgreich war

Da es sich bei Multibanco um eine synchrone Zahlungsmethode handelt und die Kundin/der Kunde bereits Gelder gesendet hat, erfolgt die Zahlung sofort, sofern kein unerwarteter Fehler auftritt.

Sie erhalten außerdem das folgende Webhook-Ereignis, wenn die Zahlung erstellt wird:

Ereignis	Beschreibung
`charge.succeeded`	Die Abbuchung war erfolgreich und die Zahlung ist abgeschlossen.

Wir empfehlen, dass Sie sich auf das Webhook-Ereignis charge.succeeded verlassen, um Ihre Kundin/Ihren Kunden zu benachrichtigen, dass der Zahlungsvorgang abgeschlossen und die Bestellung bestätigt wurde. In unseren Best Practices finden Sie weitere Informationen dazu, wie Sie Zahlungsmethoden am besten mithilfe von Webhooks integrieren.

Angefochtene Zahlungen

Das Risiko von Betrug oder Zahlungen, die nicht zugeordnet werden können, ist bei Multibanco äußerst gering, da die Kund/innen Gelder von ihrem Bankkonto überweisen müssen. Daher gibt es kein Verfahren für Zahlungsanfechtungen, die Rückbuchungen und damit einen Einzug der Gelder von Ihrem Stripe-Konto nach sich ziehen können.

Fehlzahlungen

Da Kund/innen Zahlungen jederzeit über den Geldautomaten vornehmen können, ist es möglich, wenn auch unwahrscheinlich, dass sie Gelder an eine stornierte oder abgelaufene Quelle übermitteln. In diesen Fällen leitet Stripe, wie oben beschrieben, automatisch den Rückerstattungsvorgang für den falsch bezahlten Betrag ein.

Rückerstattungen

Mit Multibanco getätigte Zahlungen können nur innerhalb von 180 Tagen ab dem Datum der ursprünglichen Zahlung zur Rückerstattung eingereicht werden. Nach 180 Tagen kann die Zahlung nicht mehr zurückerstattet werden.

Multibanco-Zahlungen können entweder über das Dashboard oder über die API zurückerstattet werden. Multibanco selbst bietet keine Möglichkeit für Rückerstattungen, daher wird der Vorgang von Stripe abgewickelt, indem eine IBAN-Überweisung erstellt wird. Wir kontaktieren die Kundin/der Kunde über die bei Erstellung der Quelle angegebene E-Mail-Adresse. Sobald die Kundin/der Kunde ihre/seine Kontodaten angegeben hat, erhält sie/er eine entsprechende Gutschrift. Abgesehen von der anfänglichen Rückerstattungsanfrage ist keine Interaktion seitens des Händlers erforderlich.

Einige Nutzer/innen möchten möglicherweise die Erfassung der IBAN-Daten für die Rückerstattung selbst abwickeln. Für Multibanco-Rückerstattungen wird die IBAN-Nummer des/der Kund/in, der Name des/der Kontoinhaber/in sowie die vollständige Adresse mit Straße, Stadt, Land und Postleitzahl benötigt. Bitte kontaktieren Sie uns, um mehr über diese Option zu erfahren.

Ablauf von Quellen

Eine chargeable Multibanco-Quelle muss innerhalb von sechs Stunden, nachdem sie chargeable wurde, belastet werden. Andernfalls wechselt ihr Status automatisch zu canceled, und Ihre Integration empfängt das Webhook-Ereignis source.canceled. Sobald eine abrechenbare Quelle storniert wird, wird die authentifizierte Multibanco-Zahlung des/der Kund/in automatisch rückerstattet – es wird kein Geld auf Ihr Konto transferiert. Stellen Sie daher sicher, dass die Bestellung auf Ihrer Seite storniert wird und dass der/die Kund/in benachrichtigt wird, wenn Sie das Ereignis source.canceled empfangen.

Außerdem werden pending Quellen nach sieben Tagen storniert, wenn sie nicht für den Erhalt von Geldern verwendet werden. Dadurch wird sichergestellt, dass alle Quellen schließlich vom Zustand pending in den Zustand canceled übergehen, wenn sie nicht verwendet werden.