Multibanco-Zahlungen mit SourcesBeta
Achtung
Wir haben die Sources API eingestellt und beabsichtigen, die Unterstützung für lokale Zahlungsmethoden zu entfernen. Wenn Ihre Integration derzeit Multibanco mit der Sources API nutzt, müssen Sie auf die Payment Methods API umstellen. Wir werden Ihnen weitere Informationen zu diesem Thema per E-Mail mitteilen.
Stripe-Nutzer/innen in Europa und den Vereinigten Staaten können Multibanco-Zahlungen von Kund/innen 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 Kund/innen 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 Ihr/e Kund/in 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 Ihr/e Kund/in 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 Erstellung einer Quelle 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 dem/der Kund/in 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 zuerst die Bibliothek in Ihre Website ein und legen Ihren veröffentlichbaren API-Schlüssel fest. Sobald Sie die Bibliothek eingebunden haben, verwenden Sie die folgende createSource
-Methode, um clientseitig eine Quelle 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 desSource
-Objekts darstelltlivemode
: gibt an, ob es sich um eine Live-Zahlung handelt, der Wert ist entwedertrue
oderfalse
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 mobile Anwendung zu integrieren, geben Sie das URI-Schema Ihrer Anwendung als Wert für redirect[return_url]
an. Dadurch werden Ihre Kund/innen nach Abschluss der Autorisierung zurück zur App geleitet. 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.
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 über Webhooks ermittelt, wann die Quelle abrechenbar wird, um eine Zahlung zu erstellen. In unseren Best Practices finden Sie weitere Informationen dazu, wie Zahlungsmethoden am besten mit Webhooks integriert werden.
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 Kund/innen interagieren, finden Sie in unserem Leitfaden zu Quellen und Kund/innen.
Bestätigen, dass die Zahlung erfolgreich war
Da es sich bei Multibanco um eine synchrone Zahlungsmethode handelt und der/die Kund/in 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 das Webhook-Ereignis charge.succeeded
nutzen, um Ihre Kund/innen über den abgeschlossenen Zahlungsvorgang und die Bestätigung der Bestellung zu informieren. In unseren Best Practices finden Sie weitere Informationen dazu, wie Zahlungsmethoden am besten mithilfe von Webhooks integriert werden können.
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 den/die Kund/in über die bei Erstellung der Quelle angegebene E-Mail-Adresse. Sobald der/die Kund/in seine/ihre Kontodaten angegeben hat, erhält er/sie 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.