Abonnements mit dem Toolkit zu Stripe Billing migrieren

Erstellen Sie eine Sandbox im Dashboard, wenn Sie zuerst eine Testmigration durchführen möchten.

1. Navigieren Sie zu Dashboard > Abonnements > Migrationen.

   Alternativ können Sie auf das Überlaufmenü () neben + Abonnement erstellen klicken und Abonnements migrieren auswählen.

2. Um Ihre Migration zu starten, klicken Sie auf Loslegen.

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:

• Basic
• Multipreisartikel
• Ad-hoc-Preise

Beispiele für CSV-Dateien für gängige Migrationsszenarien finden Sie auch in der Toolkit-CSV-Referenz.

1. Klicken Sie auf CSV-Vorlage herunterladen.

2. 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:

3. 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.

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

Wenn die hochgeladene Datei Fehler enthält, zeigt das Toolkit eine Übersicht über die Fehler an. So beheben Sie die Fehler:

1. Klicken Sie auf Datei herunterladen, um alle Fehler zu überprüfen.

2. Überprüfen Sie die Spalte processing_error, um die Fehler anzuzeigen.

3. 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_date-Bereich	Stellen Sie sicher, dass das start_date für jedes Abonnement mindestens 24 Stunden in der Zukunft liegt.
   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_behavior haben (inklusiv vs. exklusiv).

4. Klicken Sie auf Überarbeitete Datei hochladen, um die korrigierte CSV-Datei erneut hochzuladen (die Größenbeschränkung der CSV-Datei beträgt 120 MB).

5. Warten Sie auf die erneute Validierung, um den neuesten Validierungsstatus anzuzeigen.

Nachdem Stripe Ihre CSV-Datei validiert hat, überprüfen Sie die Übersicht Ihrer hochgeladenen Abonnements auf Unstimmigkeiten:

1. Ü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

2. 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.

Nachdem Sie Ihre hochgeladenen Abonnements überprüft haben, verfolgen Sie den Fortschritt Ihrer Migration:

Migration läuft

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. So können Ihre Abonnements 24 Stunden lang in einem geplanten Status verbleiben, bevor sie live gehen. In einer Sandbox wird die Pufferzeit für eine schnellere Auswertung und Prüfung auf 1 Stunde reduziert.

Geplante Abonnements

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

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.

Abonnements überwachen

Wenn Sie Ihre Abonnements nach dem Start der Migration überwachen, achten Sie auf Probleme mit Zahlungsmethoden.

Überprüfen Sie beispielsweise Transaktion auf nicht wiederherstellbare Ablehnungscodes für Aussteller/innen wie incorrect_number und Maßnahmen ergreifen, um sicherzustellen, dass Rechnungen bezahlt werden. Erwägen Sie, Kundinnen/Kunden mit ungültigen Zahlungsmethoden über andere Kanäle als E-Mail zu benachrichtigen, beispielsweise über Textnachrichten oder In-App-Benachrichtigungen.

Wenn Sie den automatischen Zahlungseinzug verwenden, überprüfen Sie offene oder überfällige Rechnungen, um sicherzustellen, dass keine Standardzahlungsmethoden für die Kundinnen und Kunden fehlen. Dies kann dazu führen, dass kein Zahlungseinzug für die Rechnung möglich ist.

Alle Migrationen anzeigen:

1. Wählen Sie die Migration, die Sie anzeigen möchten, in Ihren Migrationen.

2. 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