SEPA-Daten importieren
Wenn Sie SEPA-Daten von Ihrem bisherigen Abwickler migrieren, können Sie die Daten in Stripe als Standard-Zahlungsmethodenobjekt (pm_
) oder als veraltetes Quellobjekt (src_
) importieren. Die Payment Intents API unterstützt nur pm_
-Kennungen für alle Stripe-Produkte, aber Ihre Integration könnte aufgrund der folgenden Überlegungen eine davon bevorzugen.
- Wenn Sie eine Drittanbieter-Abonnementplattform mit Stripe verwenden, erkundigen Sie sich bei der Plattform oder Ihren Entwickler/innen, ob sie
pm_
odersrc_
für SEPA-Transaktionen bevorzugen. - Wenn Sie bereits Zahlungsdaten in Ihrem Stripe-Konto haben, versuchen Sie, den Typ zu wählen, den Sie bereits verwenden:
pm_
: Verwenden Sie die Payment Methods API in Verbindung mit der Payment Intents API.src_
: Wenn Ihre bestehende Integration bereitssrc_
-Objekte verwendet, können Sie davon profitieren, wenn Sie Ihre SEPA-Daten entsprechend importieren und dann zu der Payment Intents API und der Payment Methods API wechseln.
- Bei jeder Option gelten unterschiedliche Anforderungen für Benachrichtigungen:
- Zahlungsmethoden geben automatische E-Mail-Benachrichtigungen an Kundinnen/Kunden aus, wenn ihre SEPA-Zahlungsmethode belastet wird. Daher benötigen importierte Daten eine E-Mail-Adresse für jedes Zahlungskonto. Sie können automatische E-Mail-Benachrichtigungen nach der Migration deaktivieren.
- Quellen benötigen keine E-Mail-Adressen und Sie können die Kommunikation manuell verwalten.
Importieren der Mandate
Im Zusammenhang mit SEPA beziehen sich Mandate auf die ursprüngliche autorisierte Vereinbarung, die der Kunde/die Kundin und das Unternehmen bereits geschlossen haben.
In Stripe bedeutet das Erstellen eines neuen Mandatsobjekts nicht, dass ein neues Mandat von Grund auf neu erstellt wird. Beim Import erstellen wir ein neues Mandatsobjekt das:
- Verwendet die gleiche
mandate_
wie Ihre ursprüngliche Vereinbarung.reference - Stellt die gleiche Vereinbarung dar, die der Kunde/die Kundin ursprünglich für die erste Lastschriftanweisung autorisiert hat.
Von Kundinnen/Kunden werden keine neuen Informationen benötigt. Die ursprüngliche Vereinbarung bleibt gleich.
Gläubiger-ID
Eine SEPA-Gläubiger-Identifikationsnummer (Gläubiger-ID) ist eine ID, die jeder SEPA-Lastschriftzahlung zugeordnet wird und das Unternehmen kennzeichnet, das die Zahlung anfordert. Unternehmen können zwar mehrere Gläubiger-IDs haben, aber jede Gläubiger-ID ist eindeutig und ermöglicht Kundinnen/Kunden, die Lastschriften zuzuordnen.
Standardmäßig ist Ihr Stripe-Konto so konfiguriert, dass beim Einzug von SEPA-Lastschriftzahlungen eine Gläubiger-ID von Stripe verwendet wird. Auf Kontoauszügen wird Stripe Payments zusammen mit der konfigurierbaren Stripe-Zahlungsbeschreibung angezeigt. Wir empfehlen, dass Sie Folgendes durchführen:
- Konfigurieren Sie eine erkennbare Zahlungsbeschreibung in der Abrechnung, um sicherzustellen, dass Kundinnen/Kunden Zahlungen erkennen, und um das Risiko von Zahlungsanfechtungen zu verringern.
- Verwenden Sie Ihre eigene Gläubiger-ID, um die Anfechtungsraten zu senken und die Erkennbarkeit der Zahlung an Sie für Ihre Kundinnen/Kunden zu verbessern.
- Wenn Sie die Stripe-Gläubiger-ID verwenden, verwenden Sie Stripe Checkout, um Mandate von Ihren Kundinnen/Kunden für SEPA-Lastschriften einzuziehen.
Sie können Ihre eigene Gläubiger-ID auf der Seite Zahlungsmethodeneinstellungen konfigurieren. Wenn Sie Ihre eigene Gläubiger-ID verwenden, wird nicht mehr Stripe, sondern Ihr Name auf den Abrechnungen angezeigt.
Beispiel für ein SEPA-Bankmandat bei Verwendung der Gläubiger-ID von Stripe
From Account Account name: CURRENT-ACCOUNT BIC: BANBICKIEXXXXX IBAN: IE11BANK11111111111111 Originator Details Originator name: Stripe Payments Europe Ltd Creditor Identifier: BE111111111111 The Creditor Identifier is a unique identifier used by the company to process collections. UMR: UMR123 PSP The Unique Mandate Reference (UMR) is specific to the mandate you have signed and identifies each direct debit mandate. Additional details Status: Active
Beispiel für ein SEPA-Bankmandat bei Verwendung Ihrer eigenen Gläubiger-ID
From Account Account name: CURRENT-ACCOUNT BIC: BANBICKIEXXXXX IBAN: IE11BANK11111111111111 Originator Details Originator name: Merchant Creditor ID Name Creditor Identifier: BE222222222222 The Creditor Identifier is a unique identifier used by the company to process collections. UMR: UMR123 PSP The Unique Mandate Reference (UMR) is specific to the mandate you have signed and identifies each direct debit mandate. Additional details Status: Active
Migrationsbenachrichtigung
Informieren Sie Ihre Kundinnen/Kunden über die Migration, bevor sie stattfindet. Sie müssen keine erneute Genehmigung erteilen oder ein neues SEPA-Lastschriftmandat einrichten. Die Genehmigung, die Sie bereits haben, ist ausreichend.
Allgemeine Richtlinien für die Kommunikation:
Weisen Sie u. a. auf folgende Änderungen hin:
- Gläubiger-ID, wenn Sie sich für die Gläubiger-ID von Stripe entscheiden
- Name des Gläubigers, wenn Sie sich für die Gläubiger-ID von Stripe entscheiden
- IBAN der Empfängerbank
Stellen Sie sicher, dass den Kundinnen/Kunden versichert wird, dass ihr aktuelles Mandat gültig ist, ohne dass sie Maßnahmen ergreifen müssen, es sei denn, sie entscheiden sich, das Mandat zu kündigen.
Benachrichtigung zur SEPA-Lastschrift
Die SEPA-Regeln besagen, dass Sie Ihre Kundinnen/Kunden benachrichtigen müssen, wenn Sie ihre SEPA-Zahlungsmethode belasten.
Sie können festlegen, dass Stripe diese E-Mail-Benachrichtigung automatisch sendet, oder Sie können sie manuell senden.
Damit Stripe die Benachrichtigung senden kann, müssen Sie beim SEPA-Import das E-Mail-Feld in die Daten aufnehmen. Das E-Mail-Feld ist im Rahmen des Imports der SEPA-Zahlungsmethode ( pm_
) immer ein Pflichtfeld.
Anleitung für SEPA-Dateien
- Ein Abwickler kann eine Reihe unterschiedlicher Felder bereitstellen.
- Wir empfehlen Ihrem Abwickler, einen vollständigen Export aller Kunden- und Zahlungsmethodendaten an Stripe bereitzustellen.
- Stripe kann bei Bedarf unnötige Felder aus den Daten des bisherigen Abwicklers herausfiltern.
- Stripe kann mehrere empfangene Dateien zusammenführen, wenn entweder die alte Kunden-ID oder die alte Quell-ID in beiden Dateien vorhanden ist.
Anforderungen an die Dateiformatierung
Exportdatendateien müssen die folgenden Datenstandards erfüllen, damit wir mit einem Import fortfahren können:
- Die Datei muss im CSV-Format vorliegen.
- Die Datei muss UTF-8-kodiert sein.
- Zeilen durch ein einzelnes Zeilenumbruchzeichen
\n
abgrenzen (nicht\r\n
). - Spalten durch ein Komma (
,
) trennen. - Sie müssen alle Felder, die Kommas enthalten, in doppelte Anführungszeichen setzen (
"
). Wir empfehlen, alle Felder in doppelte Anführungszeichen einzuschließen. - Lassen Sie leere Felder vollständig leer (kein Zeichen zwischen Trennzeichen). Sie dürfen ein fehlendes Feld nicht mit
NULL
,N/A
oder einem anderen Wert kennzeichnen. - Doppelte Anführungszeichen, die Teil des Inhalts sind, gemäß CSV RFC mit einem anderen doppelten Anführungszeichen als Escape-Zeichen versehen: Beispiel:
"``William
""``Bard of Avon``""
Shakespeare``"
- Innerhalb eines Felds dürfen keine Zeilenumbruchzeichen (
\r
oder\n
) vorhanden sein. Beispiel, was zu vermeiden ist:101 1st Ave\nApt 1
. - Alle Zeilen müssen die gleiche Spaltenanzahl aufweisen.
- Spalten werden in jeder Bestellung unterstützt.
- Sie müssen sensible Datendateien mit unserem PGP-Schlüssel verschlüsseln, bevor sie über SFTP übermittelt werden.
SEPA-Datenfelder
Feld | Erforderlich | Weitere Informationen |
---|---|---|
Alte Kunden-ID | Erforderlich | Wir erstellen eine Kunden-ID für jede angegebene eindeutige alte Kunden-ID. |
Name | Erforderlich | Wir müssen den Namen der Person auf dem Mandat angeben. |
IBAN | Erforderlich | Folgen Sie der gültigen IBAN-Struktur von Stripe. |
Mandatsreferenz | Erforderlich | Bestehende Mandatsreferenz-ID |
Erforderlich* | *SEPA verlangt, dass Sie dem Kunden/der Kundin eine Benachrichtigung per E-Mail zukommen lassen, wenn seine/ihre SEPA-Zahlungsmethode belastet wird. Stripe kann diese E-Mail-Benachrichtigung automatisch senden oder Sie können sie manuell senden. Dieses Feld ist obligatorisch, wenn:
| |
Adresszeile 1 | Erforderlich* | *Obligatorisch für Nicht-EU-IBANs |
Land | Erforderlich* | *Obligatorisch für Nicht-EU-IBANs. Muss in Form des ISO-2-Buchstaben-Ländercodes vorliegen. |
Postleitzahl | Optional | Zusätzliche Metadaten |
Land | Optional | Zusätzliche Metadaten |
Telefon | Optional | Zusätzliche Metadaten |
Adresszeile 2 | Optional | Zusätzliche Metadaten |
Bundesland | Optional | Zusätzliche Metadaten |
Stripe-Kunden-ID | Optional | Zusätzliche Metadaten |
Alte Quell-ID | Optional | Zusätzliche Metadaten |
Kunden-/SEPA-Metadaten | Optional | Alle zusätzlichen Metadaten |