SEPA-Lastschriftzahlungen mit Sources
Verwenden Sie Sources, um Zahlungen mit SEPA-Lastschrift anzunehmen, einer beliebten europäischen Bankzahlungsmethode.
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 SEPA-Lastschriften mithilfe der Sources API integrieren, müssen Sie eine Migration zur Payment Methods API vornehmen.
Informationen zur Integration von SEPA-Lastschriften mit den aktuellen APIs finden Sie unter Zahlungen SEPA-Lastschrift.
Stripe-Nutzer/innen in Europa und den USA können Sources – einen einzigen Integrationspfad zum Erstellen von Zahlungen mittels einer beliebigen unterstützten Methode – verwenden, um SEPA-Lastschriftzahlungen von Kundinnen/Kunden in Ländern innerhalb der Single Euro Payments Area (SEPA) anzunehmen
Während des Zahlungsvorgangs erfasst Ihre Integration die auf EUR lautenden IBAN-Bankkontodaten Ihrer Kund/innen. Bei SEPA-Lastschriften muss der/die Bankkontoinhaber/in ein Mandat (Abbuchungsermächtigung) akzeptieren, das es Ihnen gestattet, sein/ihr Konto zu belasten. Es wird dann ein Source
-Objekt erstellt, das Ihre Integration verwendet, um eine Zahlungsanfrage durchzuführen und die Zahlung abzuschließen.
Im Rahmen von Sources ist die SEPA-Lastschrift eine Pull-basierte, wiederverwendbare und asynchrone Zahlungsmethode. Dies bedeutet, dass Sie veranlassen können, dass der Betrag vom Konto der Kundin/des Kunden abgebucht wird. Es kann bis zu 14 Werktage dauern, bis die erfolgreiche oder fehlgeschlagene Durchführung einer Zahlung bestätigt wird.
Vorsicht
Bei SEPA-Lastschrifttransaktionen gibt es ein Limit von jeweils 10.000 EUR. Für neue Nutzer/innen gibt es ein zusätzliches wöchentliches Limit von 10.000 USD, das schnell erhöht wird, wenn Sie weitere SEPA-Lastschriftzahlungen abwickeln. Wenn Sie höhere Limits benötigen, wenden Sie sich bitte an den Support.
Voraussetzung: Mandatsakzeptanz erfassen
Bevor eine Quelle erstellt werden kann, müssen Ihre Kund/innen das SEPA-Lastschriftmandat akzeptieren. Dadurch werden Sie ermächtigt, Zahlungen für den angegebenen Betrag von deren Bankkonto per SEPA-Lastschrift einzuziehen.
Wenn Ihre Kund/innen die Zahlung bestätigen, akzeptieren sie damit auch ein Mandat. Durch die Annahme werden Sie ermächtigt, die Zahlungen für den angegebenen Betrag von Bankkonto der Kund/innen per SEPA-Lastschrift einzuziehen. Sie müssen den folgenden Standard-Autorisierungstext, bei dem Rocketship Inc. durch den Namen Ihres Unternehmens ersetzt wird, in der Nähe der Schaltfläche zur Bestätigung der Zahlung anzeigen, sodass Ihre Kund/innen den Text lesen und akzeptieren können.
Vorsicht
Indem Sie Ihre IBAN angeben und diese Zahlung bestätigen, ermächtigen Sie (A) Rocketship Inc. und Stripe, unseren Zahlungsdienstleister, Anweisungen an Ihre Bank zu senden, um Ihr Konto zu belasten und (B) Ihre Bank, Ihr Konto gemäß diesen Anweisungen zu belasten. Sie haben Anspruch auf Rückerstattung von Ihrer Bank gemäß den Bedingungen Ihrer Vereinbarung mit Ihrer Bank. Eine Rückerstattung muss innerhalb von 8 Wochen ab dem Datum der Belastung Ihres Kontos beantragt werden.
Die Details des akzeptierten Mandats werden als Teil der Erstellung des Source
-Objekts generiert. Eine URL zum Anzeigen des Mandats wird als Wert für sepa_
zurückgegeben. Da dies das Mandat ist, das die Kund/innen implizit unterschrieben haben, als sie die obigen vorgeschlagenen Bedingungen akzeptiert haben, müssen sie darüber informiert werden, und zwar entweder auf der Seite mit der Zahlungsbestätigung oder per E-Mail.
Source-Objekt erstellen
Bankkontodaten sind von Natur aus sensible Informationen. Um die IBAN-Daten Ihrer Kundinnen/Kunden sicher zu erfassen und eine Quelle zu erstellen, verwenden Sie Stripe.js und das IBAN-Element. Dadurch wird verhindert, dass die Kontodaten Ihrer Kundinnen/Kunden Kontakt mit Ihrem Server haben. Außerdem wird die Menge der sensiblen Daten reduziert, die Sie sicher handhaben müssen.
Befolgen Sie den Quickstart-Leitfaden für das IBAN-Element, um Ihr Zahlungsformular zu erstellen, die IBAN Ihrer Kundinnen/Kunden zu erfassen und eine Quelle zu erstellen. Nachdem Sie ein Source-Objekt erstellt haben, können Sie im nächsten Schritt mit der Belastung der Quelle fortfahren.
Nutzerdefinierte clientseitige Quellenerstellung
Wenn Sie Bankkontodaten selbst handhaben möchten, können Sie Ihr eigenes Formular erstellen und stripe.
aufrufen, wie in der Stripe.js-Referenz beschrieben. Erfassen Sie dafür unbedingt die folgenden Informationen von Ihren Kundinnen/Kunden:
Parameter | Wert |
---|---|
type | sepa_debit |
currency | eur (Bankkonten, die für SEPA-Lastschriften verwendet werden, müssen immer in Euro geführt werden) |
sepa_ | Die IBAN-Nummer für das Bankkonto, das Sie belasten möchten, erfasst durch das IBAN-Element. Bei benutzerdefinierten Integrationen müssen Sie diese selbst erfassen und beim Aufruf von stripe. mit angeben. |
owner[name] | Der vollständige Name der/s Kontoinhaber/in. |
owner[address] | Adresse der Kontoinhaberin/des Kontoinhabers. Nur für IBANs mit diesen Ländercodes erforderlich: AD, PF, TF, GI, GB, GG, VA, IM, JE, MC, NC, BL, PM, SM, CH, WF. Erforderliche Teilfelder: country und line1 . Eine vollständige Liste der Teilfelder der Adresse finden Sie in der Dokumentation zur Sources API. |
Serverseitige Quellenerstellung
Verwenden Sie Stripe.js zum Erstellen einer Quelle für eine SEPA-Lastschrift. Dies ist zwar optional, aber wenn Sie auf diesen Schritt verzichten und die Informationen beim Erstellen eines Source
-Objekts direkt an Stripe übergeben, müssen Sie geeignete Maßnahmen ergreifen, um die sensiblen Bankdaten zu schützen, die Ihre Server durchlaufen.
Notiz
Die Adresse des/der Inhabers/in ist nur bei IBANs mit den folgenden Ländercodes erforderlich: AD, PF, TF, GI, GB, GG, VA, IM, JE, MC, NC, BL, PM, SM, CH, WF
Bei beiden Methoden gibt Stripe ein Source
-Objekt zurück, das die relevanten Details für die verwendete Zahlungsmethode enthält. Spezifische Informationen zur SEPA-Lastschrift werden im Subhash sepa_
bereitgestellt.
{ "id": "src_18HgGjHNCLa1Vra6Y9TIP6tU", "object": "source", "amount": null, "client_secret": "src_client_secret_XcBmS94nTg5o0xc9MSliSlDW", "created": 1464803577, "currency": "eur", "flow": "none", "livemode": false, "owner": {
Da es sich bei Zahlungen per SEPA-Lastschrift um eine Pull-basierte Zahlungsmethode handelt, findet während der Erstellung einer Quelle keine Geldbewegung statt. Erst nach erfolgreicher Zahlungsanfrage wird das Bankkonto der Kundin/des Kunden belastet, und Sie erhalten schließlich die Gelder.
Erstellung einer Quelle in Apps
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.
Fehlercodes
Beim Erstellen einer Quelle für Zahlungen per SEPA-Lastschrift können folgende Fehler zurückgegeben werden:
Fehler | Beschreibung |
---|---|
payment_ | Die Zahlungsmethode ist derzeit nicht verfügbar. Bitten Sie Ihre/n Kund/in, zum Fortfahren auf eine andere Zahlungsmethode auszuweichen. |
processing_ | Es ist ein unerwarteter Fehler aufgetreten, der uns daran hindert, die Quelle zu erstellen. Es sollte erneut versucht werden, die Quelle zu erstellen. |
invalid_ | Die angegebene IBAN scheint ungültig zu sein. Fordern Sie die Kundin/den Kunden auf, die Angaben zu prüfen und es erneut zu versuchen. |
invalid_ | Der Name der Inhaberin/des Inhabers ist ungültig. Er muss mindestens drei Zeichen lang sein. |
Quelle belasten
Anders als bei den meisten anderen Zahlungsmethoden sind bei SEPA-Lastschriftzahlungen nach der Erstellung der Quelle keine weiteren Aktionen seitens der Kund/innen erforderlich. Sobald der/die Kund/in seine/ihre IBAN-Daten angegeben und das Mandat akzeptiert hat, ist keine weitere Aktion erforderlich, und die resultierende Quelle ist direkt chargeable
.
Bevor Sie eine Zahlungsanfrage zum Abschließen der Zahlung erstellen, sollten Sie die Quelle einer/einem Kundin/Kunden zur späteren Wiederverwendung hinzufügen.
Quelle zu einem/einer Kund/in hinzufügen
Sie müssen eine Quelle einem Customer-Objekt hinzufügen, wenn Sie planen, sie für zukünftige Zahlungen (zum Beispiel mit einem Billing-Produkt) wiederzuverwenden.
In der Dokumentation zu Quellen und Kundinnen/Kunden finden Sie weitere Informationen dazu, wie Sie Quellen neuen oder bestehenden Customer
-Objekten hinzufügen können und wie diese miteinander interagieren.
Durchführung einer Zahlungsanfrage
Nachdem die Quelle hinzugefügt wurde, können Sie die ID des Source
-Objekts zusammen mit der ID des Customer
-Objekts verwenden, um eine Zahlungsanfrage durchzuführen und die Zahlung abzuschließen.
Das resultierende Objekt Charge wird mit dem Status pending
erstellt. In dieser Phase ist die Zahlung in Bearbeitung.
Standardmäßig erscheint die Zahlungsbeschreibung in der Abrechnung auf den Kontoauszügen Ihrer Kundinnen/Ihres Kunden, wenn Sie eine Zahlung per SEPA-Lastschrift erstellen. Wenn Sie eine nutzerdefinierte Beschreibung für eine Zahlung angeben müssen, fügen Sie den Parameter statement_
in Ihre Zahlungsanfrage ein. Zahlungsbeschreibungen in der Abrechnung sind auf 22 Zeichen beschränkt und dürfen nicht die Sonderzeichen <
, >
, '
oder "
enthalten.
Bestätigen, dass die Zahlung erfolgreich war
Bei SEPA-Lastschriftzahlungen handelt es sich um eine asynchrone Methode. Daher sind die Gelder nicht sofort verfügbar. Eine Zahlung, die über eine SEPA-Lastschriftquelle erstellt wurde, kann bis zu 14 Werktage nach ihrer Erstellung im Status „Ausstehend“ bleiben. Im Durchschnitt sind es jedoch etwa fünf Werktage. Sobald die Zahlung bestätigt ist, wird ihr Status in succeeded
geändert.
Die folgenden Ereignisse werden gesendet, wenn der Status der Zahlung aktualisiert wird:
Ereignis | Beschreibung |
---|---|
charge. | Die Zahlung wurde erfolgreich abgewickelt und ist abgeschlossen. |
charge. | Die Zahlung ist fehlgeschlagen und konnte nicht abgeschlossen werden. |
Nachdem Sie bestätigt haben, dass die Zahlung erfolgreich durchgeführt wurde, benachrichtigen Sie Ihre Kundin/Ihr Kunde, dass der Zahlungsvorgang abgeschlossen wurde und die Bestellung bestätigt ist. In unseren Best Practices finden Sie weitere Informationen dazu, wie sich Zahlungsmethoden am besten mithilfe von Webhooks integrieren lassen.
Eine Zahlung ist erfolgreich, sobald wir Gelder von der Bank des/der Kund/in erhalten. Dies ist jedoch häufig der Fall, bevor die Bank das Konto des/der Kund/in belastet hat. Wenn es ein Problem bei der Belastung des Bankkontos des/der Kund/in gibt, nachdem eine Zahlung erfolgreich war, werden die Gelder als angefochtene Zahlung abgerufen.
Testen von SEPA-Lastschrift
Sie können eine erfolgreiche oder fehlgeschlagene Abbuchung imitieren, indem Sie zunächst eine Testquelle mit einer der folgenden Test-IBAN-Kontonummern erstellen. Verwenden Sie die resultierende Quelle in einer Zahlungsanfrage, um eine Testabbuchung zu erstellen, die entweder erfolgreich oder fehlgeschlagen ist.
Fehlgeschlagene Zahlungen bearbeiten
Wenn eine Zahlung nicht bestätigt wird, wechselt ihr Status automatisch von pending
zu failed
. Sollte eine Zahlung fehlschlagen, benachrichtigen Sie Ihre Kund/innen direkt nach Erhalt des Ereignisses charge.
. Bei Verwendung der SEPA-Lastschrift möchten Sie Bestellungen gegebenenfalls erst dann abwickeln, wenn der Webhook charge.
empfangen wurde.
Wenn eine SEPA-Lastschrift fehlschlägt und wir Gründe zur Annahme haben, dass nachfolgende Zahlungen ebenfalls fehlschlagen, wird die Quelle in failed
geändert.
Notiz
SEPA-Lastschriftzahlungen können fehlschlagen, wenn Ihre Rolling-Window-Verarbeitungsgrenzen überschritten werden. Schlägt die Belastung der Quelle mit dem Fehlercode charge_
fehl, können Sie die Abbuchung zu einem späteren Zeitpunkt erneut versuchen. Kontaktieren Sie uns bitte, wenn Sie höhere Verarbeitungsgrenzen benötigen.
Kund/innen über wiederkehrende Zahlungen benachrichtigen
Gemäß Regelwerk zur SEPA-Lastschrift müssen Sie Ihre Kund/innen jedes Mal benachrichtigen, bevor eine Lastschrift von ihrem Konto vorgenommen werden kann. Sie können diese Lastschriftankündigungen separat oder zusammen mit anderen Dokumenten (zum Beispiel einer Rechnung) versenden.
Diese Lastschriftankündigungen werden mindestens 14 Kalendertage vor der Erstellung einer Zahlung gesendet. Es ist auch möglich, sie etwas später und damit zeitlich näher am Zahlungsdatum zu senden. Stellen Sie dabei aber sicher, dass aus Ihrem Mandat klar hervorgeht, wann Kund/innen eine Ankündigung erwarten können. Das von Stripe zur Verfügung gestellte Mandat sieht Lastschriftankündigungen bis zwei Kalendertage vor einer Zahlung vor, sodass sie im Zuge der Zahlungserstellung versendet werden können. Bei wiederkehrenden Zahlungen desselben Betrags (zum Beispiel bei Abonnements mit einem festen Betrag) können Sie mehrere bevorstehende Lastschriften unter Angabe der entsprechenden Datumsangaben in einer einzigen Mitteilung ankündigen.
Wenn Sie Ihren Kund/innen eine Mitteilung senden, muss diese Folgendes enthalten:
- Die letzten 4 Ziffern des Bankkontos der/des Zahlungspflichtigen
- Die Mandatsreferenz (im
Source
-Objekt:sepa_
)debit[mandate_ reference] - Den einzuziehenden Betrag
- Ihre SEPA-Gläubiger-Identifikationsnummer
- Ihre Kontaktinformationen
Webhooks oder automatisierte E-Mails verwenden
Source-Objekte bieten Tools, mit denen Sie Ihre Nutzer/innen gesetzeskonform benachrichtigen können. Bei der Erstellung der Quelle können Sie eine mandate[notification_
bestimmen. Folgende Werte sind möglich:
Wert | Beschreibung |
---|---|
email | Wenn Sie Zahlungen erstellen, benachrichtigen wir Ihre Kund/innen automatisch per E-Mail. |
manual | Wenn Sie Zahlungen erstellen, geben wir einen source. -Webhook mit allen erforderlichen Informationen zur Erstellung einer konformen Benachrichtigung aus. Nach Empfang dieses Webhooks sollten Sie Ihre Kund/innen über den von Ihnen gewählten Kanal benachrichtigen. |
none | Keine der oben genannten Auswahlmöglichkeiten. Sie möchten Lastschriftankündigungen außerhalb von Stripe erstellen. |
Standardmäßig ist mandate[notification_
bei der Erstellung der Quelle auf none festgelegt, dies lässt sich aber noch nachträglich ändern.
Gläubiger-Identifikationsnummer für Unternehmen in der EU erhalten
Notiz
Dieser Abschnitt gilt nur für Unternehmen in der EU.
Für Unternehmen in der EU wird Ihre SEPA-Gläubiger-Identifikationsnummer jeder SEPA-Lastschriftzahlung zugeordnet und identifiziert das Unternehmen, das die Zahlung anfordert. Unternehmen können zwar mehrere Gläubiger-Identifikationsnummern haben, aber jede Gläubiger-Identifikationsnummer ist eindeutig und ermöglicht Kund/innen, die Lastschriften leichter zuzuordnen. So kann die Wahrscheinlichkeit angefochtener Zahlungen verringert werden. Einige Zahlungsanbieter fordern keine eigene SEPA-Gläubiger-Identifikationsnummer an. Stripe hingegen fordert die SEPA-Gläubiger-Identifikationsnummer an, um das Erlebnis für Ihre Kund/innen zu verbessern.
Sie können eine SEPA-Gläubiger-Identifikationsnummer bei einem Finanzinstitut in dem Land beantragen, in dem Sie Ihren Hauptsitz oder Wohnsitz haben. Beispielsweise können Sie die SEPA-Gläubiger-Identifikationsnummer bei der Bank anfordern, bei der Sie Ihr Konto führen. In der Regel erfolgt die Beantragung online und kann einige Tage in Anspruch nehmen. In einigen Fällen verlangt Ihre Bank gegebenenfalls zusätzliche Schritte zur Ausgabe einer Gläubiger-Identifikationsnummer. Teilen Sie bei der Beantragung der SEPA-Gläubiger-Identifikationsnummer bei Ihrer Bank mit, dass die Bank keine SEPA-Lastschriftzahlungen für Sie abwickeln soll.
Wenn Sie Probleme haben, eine Gläubiger-Identifikationsnummer zu erhalten, kontaktieren Sie uns.
Angefochtene Zahlungen
Beim SEPA-Lastschriftverfahren haben Bankkontoinhaber/innen die Möglichkeit, Zahlungen anzufechten. Daher sollten Sie die entsprechenden Entscheidungen in Bezug auf Ihr Unternehmen treffen und wissen, wie Sie mit SEPA-Lastschriftzahlungen umgehen.
Dabei kann eine Zahlung bis zu acht Wochen nach der Lastschrift ohne Angabe von Gründen über die Bank der Kontoinhaberin/des Kontoinhabers angefochten werden. Alle Zahlungsanfechtungen innerhalb dieses Zeitraums werden automatisch anerkannt.
Nach acht Wochen und bis zu 13 Monate nach der Erstellung der Zahlung können Kund/innen eine Zahlung nur noch dann bei ihrer Bank anfechten, wenn die Lastschrift als nicht autorisiert eingestuft wird. In diesem Fall stellen wir der Bank der Kundin/des Kunden automatisch das Mandat zur Verfügung, dem die Kundin/der Kunde zugestimmt hat. Dies führt aber nicht automatisch zur Aufhebung der Anfechtung: Die Bank der Kundin/des Kunden kann trotzdem zu dem Schluss kommen, dass die Lastschrift durch das Mandat nicht autorisiert war und ihre Kundin/ihr Kunde Anspruch auf eine Erstattung hat.
Es kann auch zu einer Zahlungsanfechtung kommen, wenn die Bank des/der Kund/in aufgrund eines Problems das Konto nicht belasten kann (beispielsweise wenn das Konto gesperrt ist oder nicht über ausreichend Guthaben verfügt), aber bereits die Gelder für die Zahlung bereitgestellt hat. In diesem Fall fordert die Bank diese Gelder mittels Zahlungsanfechtung zurück.
Bei einer Zahlungsanfechtung wird das Webhook-Ereignis charge.
übermittelt und Stripe zieht den angefochtenen Betrag und die Anfechtungsgebühr von Ihrem Stripe-Guthaben ab. Die Anfechtungsgebühr variiert je nach Standard-Abrechnungswährung Ihres Kontos:
Abrechnungswährung | Anfechtungsgebühr |
---|---|
CHF | 10,00 Fr |
DKK | 75,00 kr. |
EUR | 7,50 € |
GBP | 7,00 £ |
NOK | 75,00 kr. |
SEK | 75,00 kr. |
USD | 10,00 $ |
Im Gegensatz zur Anfechtung von Kreditkarten ist die Anfechtung von SEPA-Lastschriften endgültig und es kann kein Widerspruch eingelegt werden. Wenn eine Kundin/ein Kunde eine Zahlung erfolgreich anfechtet, müssen Sie sich mit ihr/ihm in Verbindung setzen, um die Situation zu klären. Wenn Sie sich einigen können und Ihre Kundin/Ihr Kunde bereit ist, den Betrag zurückzuzahlen, muss eine neue Zahlung vorgenommen werden.
In der Regel wird bei jeder Zahlungsanfechtung ein Grund angegeben, was aber von Land zu Land variieren kann. In Deutschland werden zum Beispiel aus Datenschutzgründen keine zusätzlichen Angaben gemacht.
Rückerstattungen
Rückerstattungen von Zahlungen per SEPA-Lastschrift müssen innerhalb von 180 Tagen ab dem Datum der Zahlung beantragt werden. Nach 180 Tagen ist eine Rückerstattung nicht mehr möglich. Ähnlich wie bei den zeitlichen Verzögerungen bei Zahlungen per SEPA-Lastschrift liegt die Bearbeitungszeit für Rückerstattungen in der Regel bei drei bis vier Werktagen. Wenn Sie versehentlich eine Lastschrift vorgenommen haben, können Sie eine Anfechtung vermeiden, indem Sie die Kundin/den Kunden sofort kontaktieren.
Rückerstattungen werden erst nach Abschluss des Zahlungsvorgangs verarbeitet. Wenn Sie eine vollständige oder anteilige Rückerstattung für eine noch nicht abgeschlossene Zahlung erstellen, wird die Rückerstattung ausgeführt, sobald sich der Status des Charge
-Objekts in succeeded
ändert. Sollte sich der Status des Charge
-Objekts in failed
ändern, wird die vollständige oder anteilige Rückerstattung als storniert markiert, da das Geld nicht vom Bankkonto des Kunden/der Kundin eingezogen wurde.
Rückerstattungen von SEPA-Lastschriften auf das Konto einer Kundin/eines Kunden werden nicht explizit gekennzeichnet. Sie werden wie eine Gutschrift verarbeitet und enthalten einen Verweis auf die Zahlungsbeschreibung der ursprünglichen Zahlung.
Je nachdem, wie Banken SEPA-Lastschriften verarbeiten und wie lange sie dafür brauchen, kann es zu Missverständnissen zwischen Ihnen, Ihren Kund/innen, deren Bank und Stripe kommen. So kann es zum Beispiel passieren, dass sich eine Kundin/ein Kunde sowohl an Sie als auch an die Bank wendet, um eine Zahlung anzufechten. Wenn Sie dann bereits proaktiv die Zahlung zurückerstatten, während die Bank ihrerseits eine Zahlungsanfechtung einleitet, erhält die Kundin/der Kunde unter Umständen zwei Gutschriften für dieselbe Transaktion.
Wenn Sie Rückerstattungen ausstellen, sollten Sie Ihre Kund/innen direkt darüber informieren, dass es bis zu fünf Werktage dauern kann, bis das Geld auf dem Bankkonto eingeht.