Wenn Sie wiederverwendbare Zahlungsmethoden über die Sources-API (SEPA-Lastschrift, BACS-Lastschriftverfahren oder Alipay) verarbeiten, müssen Sie eine Datenmigration durchführen, um Ihre wiederverwendbaren Sources in PaymentMethods umzuwandeln. Damit können Sie die Verarbeitung wiederkehrender Zahlungen ohne Unterbrechung für Ihre bestehenden Kundinnen und Kunden fortsetzen. Um Sie Schritt für Schritt durch diesen Migrationsprozess zu führen, haben wir im Stripe-Dashboard ein Datenmigrationstool hinterlegt.
Wie rufe ich dieses Migrationstool auf?
Sie können auf das Tool zugreifen, indem Sie diesem Link zu Ihrem Dashboard folgen. Wenn nicht bereits geschehen, werden Sie zunächst zu einer Betaversion der Workbench eingeladen. Akzeptieren Sie die Einladung, indem Sie auf „Migration über die Workbench starten“ klicken.
Die Hauptseite dieses Tools ist die Registerkarte „Übersicht“. Hier sehen Sie Folgendes:
Sobald Sie die Verarbeitung von Zahlungen über die Sources-API beendet haben, werden alle Zahlungsmethoden mit grünen Häkchen dargestellt. Diese zeigen an, dass Sie die Migration abgeschlossen haben.
Neben der Registerkarte „Übersicht“ wird eine weitere Registerkarte für jede wiederverwendbare Zahlungsmethode angezeigt, für die eine Datenmigration erforderlich ist. Diese Registerkarte trägt den Titel „Sources der Art {type} migrieren“, wobei {type} für „SEPA-Lastschrift“, „BACS-Lastschriftverfahren“ oder „Alipay“ steht.
Auf dieser Registerkarte werden Sie durch den Migrationsprozess geführt. Die einzelnen Schritte sind auf der linken Seite hervorgehoben, die Anweisungen zu jedem Schritt finden Sie auf der rechten Seite.
Wann sollte ich das Migrationstool verwenden?
Führen Sie die Migration am besten erst durch, nachdem Sie Ihre Integration zur Verwendung der PaymentIntents und PaymentMethods API migriert haben, sodass Sie keine neuen wiederverwendbaren Source-Objekte mehr erstellen. Im ersten Schritt des Tools wird überprüft, ob Sie in den letzten 24 Stunden Sources erstellt haben.
Kann ich das Migrationstool mehrmals ausführen?
Wir empfehlen, die Migration einmal auszuführen, um alle Source-Objekte in einem Durchgang zu migrieren. Wenn Sie das Migrationstool jedoch ein weiteres Mal ausführen müssen, ist das kein Problem. Das Tool prüft zunächst, ob bereits ein Source-Objekt migriert wurde. PaymentMethods werden nur für Objekte erstellt, die zuvor nicht migriert wurden.
Ist das Migrationstool sicher? Kann ich es verwenden, ohne den Zahlungsablauf zu unterbrechen?
Ja, Sources können problemlos in PaymentMethods umgewandelt werden (Schritt 2). Beide Objekttypen – die alten Sources und die neuen PaymentMethods – sind aktiv und abrechnungsfähig (d. h. es können Zahlungen damit erstellt werden). Durch die Umwandlung kommt es also nicht zur Unterbrechung Ihrer Zahlungsabläufe.
Die neueren Objekte werden in Ihren Zahlungsabläufen erst verwendet, nachdem Sie den Code aktualisiert oder die neuen PaymentMethods in Schritt 4 für Kundinnen und Kunden, Rechnungen oder Abonnements als Standard festgelegt haben. Schritt 6 ist der einzige, der nicht rückgängig gemacht werden kann. Mit diesem Schritt werden die alten Sources getrennt und können nicht wiederverwendet werden. Bevor Sie diesen Schritt ausführen, stellen Sie sicher, dass Sie alle alten Source-Objekte aus Ihrer Codebasis entfernt und die erforderlichen Updates vorgenommen haben, anstatt auf die neuen PaymentMethods zu verweisen.
Wie kann ich das Tool vor der Ausführung in der Produktionsumgebung testen?
Sie können das Migrationstool im Test-Modus nutzen, indem Sie das Stripe-Dashboard über den Schalter „Test-Modus“ oben rechts auf den Test-Modus umstellen. Alternativ rufen Sie https://dashboard.stripe.com/test/dashboard auf. Wenn sich das Dashboard im Test-Modus befindet, können Sie die Migration für bestehende wiederverwendbare Testobjekte ausführen (oder mit der Stripe API neue Test-Modus-Objekte für die Migration erstellen).
Wie funktioniert das Migrationstool bei einer Connect-Plattform?
Falls alle Source-Objekte direkt mit Ihrem Plattformkonto verbunden sind, können Sie das Migrationstool so nutzen, wie es konzipiert wurde, und dem oben dargestellten Migrationsprozess folgen.
Falls die Source-Objekte jedoch Ihren verbundenen Konten zugewiesen sind, können Sie sich beim Stripe-Dashboard der jeweiligen verbundenen Konten anmelden, um die Datenmigration für sie auszuführen. Wir wissen, dass dieser Prozess bei vielen verbundenen Konten sehr aufwändig sein kann. Wir arbeiten bereits an einem besseren Ansatz und werden ein Update für Plattformen bereitstellen, sobald eine Lösung verfügbar ist. Falls Sie direkt mit uns zusammenarbeiten möchten, um diesen Migrationsschritt für eine große Anzahl verbundener Konten durchzuführen, wenden Sie sich gerne an uns.