Kartendaten importieren
Migrieren Sie Ihre Kartendaten, einschließlich Standardkarten, Einschränkungen und Adressvalidierungen.
Wenn Sie Kartendaten von Ihrem bisherigen Abwickler migrieren, können Sie die Daten in Stripe als Standard-Zahlungsmethoden-Objekt (pm_
) oder als Legacy-Kartenobjekt (card_
) importieren. Die Payment Intents API unterstützt alle Stripe-Produkte für beide Kartenzahlungsarten, aber Ihre Integration könnte eine aufgrund der folgenden Überlegungen bevorzugen.
Wenn Sie eine Drittanbieter-Abonnementplattform mit Stripe verwenden, erkundigen Sie sich bei der Plattform oder Ihren Entwickler/innen, ob sie das eine oder andere bevorzugen.
Wenn Sie bereits Zahlungsdaten in Ihrem Stripe-Konto haben, versuchen Sie, dem Typ zu wählen, den Sie bereits verwenden:
pm_
: Verwenden Sie die Payment Methods API in Verbindung mit der Payment Intents API.card_
: Verwenden Sie die Card API in Verbindung mit der Payment Intents API.src_
: Sie können weiterhin die veraltete Sources API verwenden, wir empfehlen jedoch, auf die Payment Intents API umzustellen, um auf weitere Funktionen zugreifen zu können.
Standardkarten
Eine Standardkarte ist die primäre Karte, die ein Kunde/eine Kundin für wiederkehrende Zahlungen, Abonnements oder als Standard-Zahlungsmethode für zukünftige Transaktionen festlegt oder auswählt. Wenn Sie eine Karte als default
kennzeichnen, wird sie automatisch zur Zahlungsmethode für die nächste Transaktion, sofern Sie nichts anderes angeben. Verwenden Sie diese Funktion für abonnementbasierte Dienste, die automatische wiederkehrende Zahlungen erfordern. Sie können eine neue Karte als neue Standard-Zahlungsmethode festlegen oder sie als zusätzliche Zahlungsmethode hinzufügen, ohne die aktuelle Standardeinstellung zu ändern.
Typ | Objektpräfix | Migrationsverhalten |
---|---|---|
Karte | card_ | Legt eine Standardkarte beim Import fest. Wenn in der Datendatei nicht angegeben, wird die erste importierte Karte zur Standardkarte. |
Zahlungsmethode | pm_ | Benötigt keine Standardkarte. Wenn in der Datendatei nicht angegeben, ist keine Karte die Standardkarte. |
Quelle | src_ | Benötigt keine Standardkarte. Wenn in der Datendatei nicht angegeben, ist keine Karte die Standardkarte. |
Standardkartendaten angeben
- Fügen Sie Standardkarteninformationen in eine separate Spalte Ihrer Datendatei ein, idealerweise mit den Werten
TRUE
undFALSE
zur Ermittlung der Standard- und Nicht-Standardkarten. - Wird ein Karte beim Import als Standard gekennzeichnet, wird die eine ggf. festgelegte aktuelle Standard-Zahlungsmethode eines/einer bestehenden Kunden/Kundin überschrieben.
Aktuelle Einschränkungen
Stripe kann keine Karten migrieren, die von Digital Wallets wie Google und Apple gespeichert werden, da diese Dienste (nicht der vorherige Anbieter) die gespeicherten Werte aus Sicherheitsgründen tokenisieren. Sie müssen alle Karten, die mit Digital Wallets verknüpft sind, als neue Zahlungsmethoden in Stripe hinzufügen.
Validierung der Adresse für Stripe Tax
Wenn Sie Kundendaten mit Stripe Tax zu einem Konto migrieren, fügen Sie aus den folgenden Gründen Kundenadressfelder hinzu:
- Genauigkeit der Steuerberechnung: Adressen helfen bei der korrekten Berechnung von Steuern in verschiedenen Zuständigkeitsbereichen.
- Einhaltung der Steuergesetze: Die lokalen Steuergesetze verlangen Adressen für die Richtigkeit von Steuerrechnungen.
- Prüfungen und Berichterstattung: Präzise Adressdaten unterstützen die Compliance bei Steuerprüfungen und verbessern die interne Analyse durch die Aufzeichnung von Transaktionsstandorten.
- Verbesserter Bezahlvorgang für Kundinnen/Kunden: Wenn Sie mit korrekten Adressen beginnen, lässt sich der Bezahlvorgang für wiederholte Kundinnen/Kunden verbessern, da eine präzise, automatische Steuerberechnung möglich ist.
- Anpassungsfähigkeit an Änderungen des Steuerrechts: Ein vollständiger Satz von Kundenadressdaten ermöglicht es einem Unternehmen, sich an Änderungen der Steuervorschriften anzupassen und so Compliance-Probleme zu vermeiden.
Kartenaktualisierer (CAU)
Dateien von Verarbeitern enthalten oft abgelaufene Karten. Der Kartenaktualisierer (CAU) von Stripe aktualisiert die gespeicherten Karteninformationen automatisch, indem neue Kartendaten von der ausstellenden Bank abgerufen und angewendet werden.
CAU maximiert die Kontinuität des Dienstes und verbessert die Autorisierungsraten, kann jedoch für jede aktualisierte Karte in Ihrem Konto Gebühren erheben. Sie können festlegen, wie wir beim Import mit abgelaufenen Karten umgehen.
- Abgelaufene Karten überspringen: Importieren Sie keine Daten abgelaufener Karten.
Notiz
CAU kann immer noch nicht abgelaufene Karten (wie gestohlene oder Ersatzkarten) aktualisieren, wodurch Zahlungen nach der Migration ausgelöst werden.
- Abgelaufene Karten importieren: Erlauben Sie dem CAU, so viele Karten wie möglich zu aktualisieren und Ihrem Konto CAU-Gebühren zu berechnen.
Funktionsweise
Nachweis der starken Kundenauthentifizierung (Strong Customer Authentication (SCA)) migrieren
Für europäische Nutzer schreibt die PSD2 (Second Payment Services Directive) eine starke Kundenauthentifizierung, Strong Customer Authentication (SCA) vor, um die Sicherheit des elektronischen Zahlungsverkehrs zu verbessern. Bei der starken Kundenauthentifizierung werden zwei von drei unabhängigen Authentifizierungsfaktoren für Transaktionen benötigt:
- Etwas, das der Kunde/die Kundin kennt (zum Beispiel ein Passwort)
- Etwas, das der Kunde/die Kundin besitzt (zum Beispiel ein Mobilgerät)
- Etwas, das der Kunde/die Kundin ist (zum Beispiel biometrische Daten)
Die Netzwerk-Transaktions-IDs Ihres vorherigen Abwicklers zeigen, dass ein Kunde/eine Kundin eine Transaktion mit der starken Kundenauthentifizierung (SCA) beim vorherigen Abwickler authentifiziert hat, sodass Stripe Ausnahmen von der starken Kundenauthentifizierung für zukünftige Transaktionen beantragen kann. So können Ihre Kundinnen und Kunden die Migration zu Stripe nahtlos durchführen und müssen sich nicht mehr erneut authentifizieren.
Wenn Ihr bisheriger Anbieter keine Transaktions-IDs angeben kann, teilen Sie uns dies in Ihrem Importanfrageformular mit, damit wir alternative Optionen anbieten können.
3DS-Mandat für japanische Stripe-Konten
Japans überarbeitete Kreditkarten-Sicherheitsrichtlinien verlangen, dass japanische Unternehmen 3D Secure 2 (3DS) bis Ende März 2025 aktivieren.
Wenn Sie ein japanisches Unternehmen sind, das 3DS nicht verwendet, melden Sie dies im Abschnitt Weitere Details des Antragsformulars für die Migration. Stripe passt unseren Support und unsere Dienstleistungen an, damit Sie die Branchenstandards einhalten können, ohne Ihre Abläufe und Ihre Sicherheit zu beeinträchtigen.
Erfahren Sie mehr über das 3DS-Mandat in Japan.
Anleitung zur Kartendatei
- 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 abgrenzen durch
,
- 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``"
- Felder dürfen keine Zeilenumbruchzeichen (
\r
oder\n
) innerhalb eines Feldes enthalten. 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.
Kartendatenfelder
Feld | Erforderlich | Weitere Informationen |
---|---|---|
Alte Kunden-ID | Erforderlich | Wir erstellen eine Kunden-ID für jede angegebene eindeutige alte Kunden-ID. |
Kartennummer | Erforderlich | Jede/r importierte Kunde/Kundin muss mindestens eine Karte haben. |
Ablaufdatum Karte | Erforderlich | Sie können diese Option als eine oder zwei Spalten (getrennte Monats- und Jahreswerte) angeben. |
Netzwerktransaktions-IDs | Erforderlich* | *Obligatorisch für von der starten Kundenauthentifizierung betroffene Kundinnen/Kunden. |
Adresszeile 1 | Erforderlich* | *Empfohlen für die Adressvalidierung. Obligatorisch für Stripe Tax. |
Ort | Erforderlich* | *Empfohlen für die Adressvalidierung. Obligatorisch für Stripe Tax. |
Bundesstaat | Erforderlich* | *Empfohlen für die Adressvalidierung. Obligatorisch für Stripe Tax. |
Postleitzahl | Erforderlich* | *Empfohlen für die Adressvalidierung. Obligatorisch für Stripe Tax. |
Land | Erforderlich* | *Empfohlen für die Adressvalidierung. Obligatorisch für Stripe Tax. Format als ISO-2-Buchstaben-Ländercode. |
Stripe-Kunden-ID | Optional | Stellen Sie eine Verarbeiterdatei oder einer Zusatzdatei bereit, um sie bestehenden Stripe-Kundinnen/-Kunden zuzuordnen. |
Alte Karten-ID | Optional | Empfohlen, wenn Sie einen Kunden/eine Kundin mit mehreren Karten in Ihrem alten Abwickler haben. |
Beschreibung | Optional | Zusätzliche Metadaten |
Optional | Zusätzliche Metadaten | |
Telefon | Optional | Zusätzliche Metadaten |
Ist Standard | Optional | Geben Sie TRUE oder FALSE an, um anzugeben, ob die Karte die Standardkarte ist. |
Name | Optional | Zusätzliche Metadaten |
Adresszeile 2 | Optional | Zusätzliche Metadaten |
Kunden-/Karten-Metadaten | Optional | Alle zusätzlichen Metadaten |