Kartendaten importieren

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.

Standardkartendaten angeben

• Fügen Sie Standardkarteninformationen in eine separate Spalte Ihrer Datendatei ein, idealerweise mit den Werten TRUE und FALSE 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. Standardmäßig gehen wir damit aus, dass Sie die Karte so eingerichtet haben, dass sie nach der Migration von der 3DS-Mandatsanforderung in Japan ausgenommen ist.

Stripe passt unser Supportangebot und unseren Service an, damit Sie Branchenstandards einhalten können, ohne dass Ihre Betriebsabläufe und Ihre Sicherheit beeinträchtigt werden.

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.
• Trennen Sie die Zeilen durch ein einzelnes Zeilenumbruchzeichen (not \r ).
• Trennen Sie Spalten 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.
• Maskieren Sie alle doppelten Anführungszeichen, die Teil des Inhalts sind, mit einem weiteren doppelten Anführungszeichen gemäß CSV RFC. Formatieren Sie zum Beispiel William "Bard of Avon" Shakespeare als "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