Abonnements mit dem Toolkit zu Stripe Billing migrieren
Erfahren Sie, wie Sie mit dem Toolkit Ihre bestehenden Abonnements zu Stripe migrieren.
Verwenden Sie das Migrations-Toolkit von Billing, um Ihre bestehenden Abonnements von einem Drittanbieter-, einem selbst entwickelten System oder einem vorhandenen Stripe-Konto zu Stripe Billing zu migrieren.
Bevor Sie loslegen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
- Falls noch nicht geschehen, schauen Sie sich die einzelnen Migrationsphasen an.
- Richten Sie eine Stripe Billing-Integration ein, bevor Sie die Migration starten. Dies ist eine einmalige Einrichtung, die Sie für zukünftige Migrationen nicht wiederholen müssen.
- Fordern Sie einen PAN-Datenimport von Ihrem aktuellen Abwickler an. Dieser Schritt ist nur erforderlich, wenn Sie von einem anderen Abwickler zu Stripe migrieren. Wenn die Daten innerhalb von Stripe migriert werden, können Sie diese Voraussetzung überspringen.
- Wenn Sie von einem Drittanbieter- oder selbst entwickelten System migrieren, sollten Sie die Kündigung Ihrer bestehenden Abonnements und die Erstellung neuer Abonnements in Stripe sorgfältig planen. Um einen Abrechnungszeitraum nicht zu verpassen, erstellen Sie zuerst die neuen Abonnements in Stripe, bevor Sie die alten Abonnements kündigen. Um eine doppelte Abrechnung zu vermeiden, kündigen Sie Abonnements in Ihrem alten System, bevor die Abonnements zur Abbuchung eingestellt werden. Planen Sie für Abonnements mit bevorstehenden Abrechnungsdaten kurz vor der Migration, dass sie nach dem Zyklus beginnen, damit sich die endgültige Rechnung im alten System befindet.
Billing-Migrations-Toolkit öffnen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Wählen Sie den Schalter für den Test-Modus in der oberen rechten Ecke aus, um zuerst eine Testmigration durchzuführen.
Navigieren Sie zu Dashboard > Abonnements > Migrationen.
Alternativ können Sie auf das Überlaufmenü () neben + Abonnement erstellen klicken und Abonnements migrieren auswählen.
Um Ihre Migration zu starten, klicken Sie auf Loslegen.
Eine CSV-Datei herunterladen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Exportieren Sie zunächst Ihre bestehenden Abonnements, indem Sie die exportierten Daten einer migrationskompatiblen CSV-Datei zuordnen. Sie können Ihre eigene CSV-Datei erstellen oder eine der folgenden von Stripe bereitgestellten CSV-Vorlagen herunterladen:
Beispiele für CSV-Dateien für gängige Migrationsszenarien finden Sie auch in der Toolkit-CSV-Referenz.
Klicken Sie auf CSV-Vorlage herunterladen.
Wählen Sie eine CSV-Vorlage (Basis-, Multipreisartikel oder Ad-hoc-Preise) basierend auf Ihrem Abrechnungsszenario.
Basis-CSV
Dieses Beispiel zeigt eine Migration für gängige Abonnement-Anwendungsszenarien wie Menge, Steuern, Abrechnungsanker, Rabatte, Testversionen und Rückdatierung.
Geben Sie die folgenden Felder für eine einfache CSV-Datei an:
CSV für Artikel mit mehreren Preisen
Dieses Beispiel zeigt eine Migration, die mehrere Produkte pro Abonnement umfasst.
Geben Sie die folgenden Felder für eine CSV-Datei mit mehreren Preisen an:
CSV für Ad-hoc-Preise
Dieses Beispiel zeigt die Abwicklung einer Abonnementmigration unter Verwendung von Ad-hoc-Preisen für bestehende Produkte.
Geben Sie die folgenden Felder für eine CSV-Datei mit Ad-hoc-Preisgestaltung an:
Geben Sie in der CSV-Datei die Details der Abonnements an, die Sie exportieren möchten.
Für Stripe-zu-Stripe-Migrationen
Wenn Sie Abonnements innerhalb von Stripe migrieren, lesen Sie das CSV-Beispiel, bevor Sie eine CSV-Datei angeben und hochladen.
Eine CSV-Datei hochladen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Klicken Sie auf CSV hochladen. Die Größenbeschränkung für CSV-Dateien beträgt 120 MB.
Stripe validiert die Datei, um zu verifizieren, dass die hochgeladenen Abonnements das erforderliche CSV-Format aufweisen. Dieser Vorgang kann je nach Größe der Datei einige Stunden dauern. Wenn die Datei gültig ist, können Sie mit dem nächsten Schritt der Migration fortfahren.
Validierungsfehler beheben![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Wenn die hochgeladene Datei Fehler enthält, zeigt das Toolkit eine Übersicht über die Fehler an. So beheben Sie die Fehler:
Klicken Sie auf Datei herunterladen, um alle Fehler zu überprüfen.
Überprüfen Sie die Spalte
processing_
, um die Fehler anzuzeigen.error Korrigieren Sie alle Fehler. Häufige Fehler sind unter anderem:
Fehler Fehlerbehebung Ungültige Datumsangaben Stellen Sie sicher, dass alle Datumsangaben im Epochen- oder Unix-Zeitstempelformat vorliegen. Falscher start_
-Bereichdate Stellen Sie sicher, dass das start_
für jedes Abonnement mindestens 24 Stunden in der Zukunft liegt.date Fehlende Daten Stellen Sie sicher, dass jeder Datensatz die erforderlichen Felder enthält. Preis und Steuern sind unvereinbar Stellen Sie sicher, dass die Preise für die angegebenen Steuersätze das gleiche tax_
haben (inklusiv vs. exklusiv).behavior Klicken Sie auf Überarbeitete Datei hochladen, um die korrigierte CSV-Datei erneut hochzuladen (die Größenbeschränkung der CSV-Datei beträgt 120 MB).
Warten Sie auf die erneute Validierung, um den neuesten Validierungsstatus anzuzeigen.
Hochgeladene Abonnements prüfen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Nachdem Stripe Ihre CSV-Datei validiert hat, überprüfen Sie die Übersicht Ihrer hochgeladenen Abonnements auf Unstimmigkeiten:
Überprüfen Sie die Zusammenfassung auf korrekte Angaben:
- Datum des Uploads
- Name der hochgeladenen Datei
- Anzahl der Abonnements
- Anzahl der Kundinnen und Kunden
- Go-Live-Datum des ersten Abonnements
Wenn alles validiert ist, klicken Sie auf Migration starten.
Wenn Fehler angezeigt werden, klicken Sie auf Migration abbrechen und starten Sie die Migration unter CSV-Datei herunterladen erneut.
Migrationsfortschritt verfolgen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Nachdem Sie Ihre hochgeladenen Abonnements überprüft haben, verfolgen Sie den Fortschritt Ihrer Migration:
Migration läuft![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Ihre Abonnements werden zum angegebenen Startdatum in die Warteschlange gestellt. Dieser Vorgang kann je nach Größe der Datei einige Minuten bis zu einigen Stunden dauern. Beispielsweise dauert die Validierung und Migration für 100.000 Abonnements etwa 30 Minuten.
Das Billing-Migrations-Toolkit verwendet den Abonnementplan, um Ihre Abonnements zu migrieren. Auf diese Weise können Ihre Abonnements 24 Stunden lang in einem geplanten Zustand bleiben, bevor sie live gehen. Im Testmodus wird die Pufferzeit für eine schnellere Auswertung und Prüfung auf 1 Stunde reduziert.
Geplante Abonnements![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Nach der Migration bleiben Ihre Abonnements 24 Stunden lang in einem geplanten Zustand, bevor sie live gehen. Sie haben 10 Stunden Zeit, um diese geplanten Abonnements mit dem Toolkit zu kündigen.
Derzeit können Sie geplante Abonnements nicht mit dem Toolkit aktualisieren. Wenn Sie Ihre geplanten Abonnements aktualisieren möchten, können Sie entweder den Update-Endpoint aufrufen oder jedes Abonnement (einzeln) im Abonnement-Dashboard aktualisieren.
Kunden können geplante Abonnements nicht über ihr Kundenportal kündigen. Sie können nur Live-Abonnements kündigen.
Mit Abonnements live gehen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Nach 24 Stunden werden Ihre geplanten Abonnements live geschaltet und die Abbuchung von den Kundenkonten erfolgt zu den jeweiligen Startterminen. Sie können alle Live-Abonnements im Dashboard anzeigen
Nachdem die Migration live gegangen ist, empfehlen wir Ihnen, Ihre Abonnements ab der ersten Zahlung zu überwachen. Stellen Sie sicher, dass die Abbuchungsdaten und -beträge für die migrierten Abonnements mit dem angegebenenstart_date übereinstimmen.
Kundinnen und Kunden können ihre Live-Abonnements im Kundenportal kündigen.
Alle Migrationen anzeigen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Alle Migrationen anzeigen:
Wählen Sie die Migration, die Sie anzeigen möchten, in Ihren Migrationen.
Um eine Migration zu öffnen, klicken Sie im Dropdown-Menü auf Ansicht.
Sie können die folgenden Felder nachverfolgen:
- Datei hochladen
- Dateiname
- Migrations-ID für Stripe-Abrechnungen
- Anzahl der Abonnements
- Migrationsstatus
OptionalMigration abbrechen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Wenn Sie Probleme mit den geplanten Abonnements feststellen, können Sie die Migration zurücksetzen und die geplanten Abonnements zurücksetzen. Das Dashboard zeigt einen Zeitstempel an, um anzuzeigen, ob Sie die Migration mit dem Toolkit noch abbrechen können. Sie haben ab dem Zeitpunkt, an dem Sie die Abonnements geplant haben, 10 Stunden Zeit, um sie zu kündigen. Nach 10 Stunden wird die Abbruchoption im Toolkit deaktiviert.
- Suchen Sie die Migration, die Sie abbrechen möchten, in Ihren Migrationen.
- Klicken Sie im Dropdown-Menü auf Migration abbrechen.
Nach 10 Stunden abbrechen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Um die Migration nach 10 Stunden abzubrechen, können Sie entweder den Cancel-Endpoint aufrufen oder jedes Abonnement einzeln im Abonnement-Dashboard abbrechen.
OptionalMehrere Migrationen durchführen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Sie können so viele gleichzeitige Abonnementmigrationen ausführen, wie Sie möchten. Teilen Sie bei großen Migrationen die Abonnements in Batches auf und beginnen Sie mit einem kleinen Batch. Dies kann Ihnen helfen, Validierungsprobleme schnell zu identifizieren und Zeit zu sparen.
So starten Sie eine neue Migration:
Klicken Sie auf Neue Migration starten.
Starten Sie den Migrationsvorgang unter CSV-Datei herunterladen erneut.
Beispiele für CSV-Dateien für gängige Migrationsszenarien finden Sie auch in der Toolkit-CSV-Referenz.