Abonnements mit dem Toolkit zu Stripe Billing migrieren

Erfahren Sie, wie Sie mit dem Toolkit Ihre bestehenden Abonnements zu Stripe migrieren.

Verwenden Sie das Billing-Migrations-Toolkit im Stripe-Dashboard, um Ihre bestehenden Abonnements von einem Drittanbietersystem, einem selbst entwickelten System oder einem vorhandenen Stripe-Konto zu Stripe Billing zu migrieren.

Bevor Sie loslegen

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

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

Gehen Sie zu Dashboard > Subscriptions > Migrations.
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

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 (Basis, Artikel mit mehreren Preisen und Ad-hoc-Preisgestaltung). Außerdem finden Sie Beispiele für CSV-Dateien für gängige Use cases für Migrationen.

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:

Attribut	Typ	Beispiel	Beschreibung
`customer` (erforderlich)	Stripe-Kunden-ID	`cus_xxx1`	Die Kennung des Kunden/der Kundin, für den/die das Abonnement erstellt werden soll.
`start_date` (erforderlich)	Zeitstempel im Epoch UNIX-Format	`1658179441`	Legt fest, wann das Abonnement erstellt wird. Sie müssen einen Wert angeben, der 24 Stunden (oder mehr) in der Zukunft liegt. In einer Sandbox können Sie diese Einstellung auf 1 Stunde in der Zukunft festlegen.
`price` (erforderlich)	Stripe-Preis-ID	`price_1LDGNmDK0D4Fox2RxIaXQkBp`	Sie müssen einen wiederkehrenden Preis verwenden. Wenn Sie mehrere Artikel migrieren, verwenden Sie stattdessen das Format `items.x.{price, quantity}`. Ad-hoc-Preise werden auch mit `adhoc_items.x.{amount, product, interval,currency}` unterstützt.
`quantity`	Anzahl	`1`	Bestimmt die Menge eines Abonnements. Standardmäßig gilt jedes Abonnement für ein Produkt, aber Stripe können Sie einem Kunden/einer Kundin mehrere Mengen eines Artikels zuweisen.
`metadata.*`	Zeichenfolge	`subscription_1`	Fügen Sie diese Schlüsselwert-Paare hinzu, die Sie an ein Objekt anhängen können. Dies ist nützlich, um zusätzliche Informationen über das Objekt in einem strukturierten Format zu speichern. Sie können beliebige Metadatenfelder hinzufügen (zum Beispiel `metadata_third_party_sub_id`). Wenn es sich um eine Migration von Stripe zu Stripe handelt, geben Sie `internal:Stripe` ein.
`automatic_tax`	Boolean	`false`	Geben Sie `true` an, um die automatischen Steuereinstellungen von Stripe Tax.
`billing_cycle_anchor`	Zeitstempel im Epoch UNIX-Format	`1658179441`	Legt das nächste Datum fest, an dem das Abonnement dem Kunden/der Kundin in Rechnung gestellt werden soll.
`coupon`	Stripe-Gutschein-ID	`50_off`	Die Kennung des Gutscheins, der auf dieses Abonnement angewendet werden soll.
`trial_end`	Zeitstempel im Epoch UNIX-Format	`1658179441`	Setzt die Phase auf „Test“ vom Startdatum bis zum `trial_end`-Datum. Sie müssen einen Wert angeben, der vor dem Enddatum des Zyklus liegt, und Sie können ihn nicht mit der Testversion kombinieren.
`proration_behavior`	Enum	`create_prorations` oder `none`	Legt fest, ob das Abonnement nach der Migration anteilmäßige Verrechnungen erstellt. Der Standardwert ist `create_prorations`.
`collection_method`	Enum	`charge_automatically` oder `send_invoice`	Bei automatischer Abrechnung versucht Stripe, das zugrunde liegende Abo am Ende jedes Rechnungsstellungszeitraums mit der Standard-Zahlungsmethode der Kundin/des Kunden zu belasten. Beim Versand einer Rechnung sendet Stripe Ihrer Kundin/Ihrem Kunden eine E-Mail mit Zahlungsanweisungen und markiert das Abo als aktiv. Bei der Erstellung ist standardmäßig `charge_automatically` eingestellt. Wenn Sie `send_invoice` verwenden, müssen Sie `days_until_due` festlegen.
`default_tax_rate`	Stripe Tax-ID	`txr_1LPcLzAWeZvbCyjpzDA4qs1l`	Legt die `default_tax_rates` des Abonnements fest. Dies bestimmt auch die `default_tax_rates` der Rechnung für alle vom Abonnement in dieser Phase ausgestellten Rechnungen. Dieser Wert ist mit `automatic_tax` nicht kompatibel.
`backdate_start_date`	Zeitstempel	`1658179441`	Legt das `start_date` des erstellten Abonnements fest, das in der Vergangenheit sein muss. Wenn festgelegt, müssen Sie `none` für das `proration_behavior` angeben. Dadurch wird die Erstellung einer anteiligen Rechnung für den Zeitraum zwischen `backdate_start_date` und dem tatsächlichen `start_date` verhindert. Weitere Informationen finden Sie unter Rückdatierung kostenlos.
`days_until_due`	Ganze Zahl	`30`	Die Anzahl der Tage ab dem Zeitpunkt der Rechnungserstellung bis zur Fälligkeit. Dieser Wert ist erforderlich und nur für Rechnungen gültig, bei denen `collection_method` auf `send_invoice` festgelegt ist.
`cancel_at_period_end`	Boolean	`false`	Geben Sie `true` an, um ein Abonnement am Ende des Zeitraums zu kündigen.

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:

Attribut	Typ	Beispiel	Beschreibung
`customer` (erforderlich)	Stripe-Kunden-ID	`cus_xxx1`	Die Kennung des Kunden/der Kundin, für den/die das Abonnement erstellt werden soll.
`start_date` (erforderlich)	Zeitstempel im Epoch UNIX-Format	`1658179441`	Legt fest, wann das Abonnement erstellt wird. Sie müssen einen Wert angeben, der 24 Stunden (oder mehr) in der Zukunft liegt. In einer Sandbox können Sie diese Einstellung auf 1 Stunde in der Zukunft festlegen.
`items.0.price` (erforderlich)	Stripe-Preis-ID	`price_1LDGNmDK0D4Fox2RxIaXQkBp`	Die Kennung des Preisobjekts. Muss ein wiederkehrender Preis sein.
`items.0.quantity`	Anzahl	`1`	Bestimmt die Menge eines Abonnements. Standardmäßig gilt jedes Abonnement für ein Produkt, aber Stripe können Sie einem Kunden/einer Kundin mehrere Mengen eines Artikels zuweisen.
`items.1.price` (erforderlich)	Stripe-Preis-ID	`price_1LujbnDCA5oQnOCew7kwa4T5`	Die Kennung des Preisobjekts. Muss ein wiederkehrender Preis sein.
`items.1.quantity`	Anzahl	`1`	Bestimmt die Menge eines Abonnements. Standardmäßig gilt jedes Abonnement für ein Produkt, aber Stripe können Sie einem Kunden/einer Kundin mehrere Mengen eines Artikels zuweisen.
`metadata_third_party_sub_id`	Zeichenfolge	`subscription_1`	Hängen Sie diese Schlüsselwertpaare an ein Objekt an. Dies ist nützlich, um zusätzliche Informationen über das Objekt in einem strukturierten Format zu speichern.
`automatic_tax`	Boolean	`false`	Geben Sie `true` an, um die automatischen Steuereinstellungen von Stripe Tax.
`billing_cycle_anchor`	Zeitstempel im Epoch UNIX-Format	`1658179441`	Legt das nächste Datum fest, an dem das Abonnement dem Kunden/der Kundin in Rechnung gestellt werden soll.
`coupon`	Stripe-Gutschein-ID	`50_off`	Die Kennung des Gutscheins, der auf dieses Abonnement angewendet werden soll.
`proration_behavior`	Enum	`create_prorations`	Legt fest, ob das Abonnement nach der Migration anteilmäßige Verrechnungen erstellt. Der Standardwert ist `create_prorations`.
`collection_method`	Enum	`charge_automatically` oder `send_invoice`	Bei automatischer Abrechnung versucht Stripe, das zugrunde liegende Abo am Ende jedes Rechnungsstellungszeitraums mit der Standard-Zahlungsmethode der Kundin/des Kunden zu belasten. Der Standardwert ist `charge_automatically`. Beim Versand einer Rechnung sendet Stripe Ihrer Kundin/Ihrem Kunden eine E-Mail mit Zahlungsanweisungen und markiert das Abo als aktiv. Bei Verwendung von `send_invoice` müssen Sie `days_until_due` festlegen.
`default_tax_rate`	Stripe Tax-ID	`txr_1LPcLzAWeZvbCyjpzDA4qs1l`	Legt die `default_tax_rates` des Abonnements fest. Dies bestimmt auch die `default_tax_rates` der Rechnung für alle vom Abonnement in dieser Phase ausgestellten Rechnungen. Dieser Wert ist mit `automatic_tax` nicht kompatibel.
`backdate_start_date`	Zeitstempel	`1705753518`	Legt das `start_date` des erstellten Abonnements fest, das in der Vergangenheit sein muss. Wenn festgelegt, müssen Sie `none` für das `proration_behavior` angeben. Dadurch wird die Erstellung einer anteiligen Rechnung für den Zeitraum zwischen `backdate_start_date` und dem tatsächlichen `start_date` verhindert. Weitere Informationen finden Sie unter Rückdatierung kostenlos.
`days_until_due`	Ganze Zahl	`30`	Die Anzahl der Tage ab dem Zeitpunkt der Rechnungserstellung bis zur Fälligkeit. Dies ist erforderlich und nur für Rechnungen gültig, bei denen `collection_method` auf `send_invoice` festgelegt ist.
`cancel_at_period_end`	Boolean	`false`	Geben Sie `true` an, um ein Abonnement am Ende des Zeitraums zu kündigen.
`add_invoice_items.0.amount`	Anzahl	`19,99`	Eine positive Zahl. Verwenden Sie vollständige Werte mit Dezimalstellen (z. B. 21,50).
`add_invoice_items.0.product`	Stripe-Produkt-ID	`prod_PjfC3kWS58IoOX`	Die Kennung des Produkts, zu dem die Rechnung hinzugefügt werden soll.
`add_invoice_items.0.currency`	Zeichenfolge	`usd`	Aus drei Buchstaben bestehender ISO-Währungscode, in Kleinbuchstaben für eine unterstützte Währung.

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:

Attribut	Typ	Beispiel	Beschreibung
`customer` (erforderlich)	Stripe-Kunden-ID	`cus_xxx1`	Die Kennung des Kunden/der Kundin, für den/die das Abonnement erstellt werden soll.
`start_date` (erforderlich)	Zeitstempel im Epoch UNIX-Format	`1710937191`	Legt fest, wann das Abonnement erstellt wird. Sie müssen einen Wert angeben, der 24 Stunden (oder mehr) in der Zukunft liegt. In einer Sandbox können Sie diese Einstellung auf 1 Stunde in der Zukunft festlegen.
`adhoc_items.0.amount` (erforderlich)	Anzahl	`19,99`	Eine positive Zahl. Verwenden Sie vollständige Werte mit Dezimalstellen (z. B. 21,50).
`adhoc_items.0.product` (erforderlich)	Stripe-Produkt-ID	`prod_NwSGSFZb7ENuTW`	Die Kennung des Produkts, das zum Ad-hoc-Preis gehört.
`adhoc_items.0.interval` (erforderlich)	Tag, Woche, Monat oder Jahr	`month`	Die Abrechnungshäufigkeit.
`adhoc_items.0.currency` (erforderlich)	Zeichenfolge	`usd`	Aus drei Buchstaben bestehender ISO-Währungscode, in Kleinbuchstaben für eine unterstützte Währung.
`adhoc_items.0.quantity`	Anzahl	`1`	Bestimmt die Menge eines Abonnements. Standardmäßig gilt jedes Abonnement für ein Produkt, aber Stripe können Sie einem Kunden/einer Kundin mehrere Mengen eines Artikels zuweisen.
`adhoc_items.1.amount`	Anzahl	`19,99`	Eine positive Zahl. Verwenden Sie vollständige Werte mit Dezimalstellen (z. B. 21,50).
`adhoc_items.1.interval`	Tag, Woche, Monat oder Jahr	`month`	Die Abrechnungshäufigkeit.
`adhoc_items.1.currency`	Zeichenfolge	`usd`	Aus drei Buchstaben bestehender ISO-Währungscode, in Kleinbuchstaben für eine unterstützte Währung.
`adhoc_items.1.quantity`	Anzahl	`1`	Bestimmt die Menge eines Abonnements. Standardmäßig gilt jedes Abonnement für ein Produkt, aber Stripe können Sie einem Kunden/einer Kundin mehrere Mengen eines Artikels zuweisen.
`metadata.source`	Anzahl	`external:zuora`	Hängen Sie diese Schlüsselwert-Paare an ein Objekt an. Dies ist nützlich, um zusätzliche Informationen über das Objekt in einem strukturierten Format zu speichern. Sie können beliebige Metadatenfelder hinzufügen (zum Beispiel `metadata_third_party_sub_id`). Wenn es sich um eine Migration von Stripe zu Stripe handelt, geben Sie `internal:Stripe` ein.
`metadata_third_party_sub_id`	Zeichenfolge	`subscription_1`	Hängen Sie diese Schlüsselwertpaare an ein Objekt an. Dies ist nützlich, um zusätzliche Informationen über das Objekt in einem strukturierten Format zu speichern.
`automatic_tax`	Boolean	`false`	Geben Sie `true` an, um die automatischen Steuereinstellungen von Stripe Tax.
`billing_cycle_anchor`	Zeitstempel im Epoch UNIX-Format	`1713615591`	Legt das nächste Datum fest, an dem das Abonnement dem Kunden/der Kundin in Rechnung gestellt werden soll.
`coupon`	Stripe-Gutschein-ID	`black_friday`	Die Kennung des Gutscheins, der auf dieses Abonnement angewendet werden soll.
`proration_behavior`	Enum	`create_prorations`	Legt fest, ob das Abonnement nach der Migration anteilmäßige Verrechnungen erstellt. Der Standardwert ist `create_prorations`.
`collection_method`	Enum	`charge_automatically` oder `send_invoice`	Bei automatischer Abrechnung versucht Stripe, das zugrunde liegende Abo am Ende jedes Rechnungsstellungszeitraums mit der Standard-Zahlungsmethode der Kundin/des Kunden zu belasten. Der Standardwert ist `charge_automatically`. Beim Versand einer Rechnung sendet Stripe Ihrer Kundin/Ihrem Kunden eine E-Mail mit Zahlungsanweisungen und markiert das Abo als aktiv. Bei Verwendung von `send_invoice` müssen Sie `days_until_due` festlegen.
`default_tax_rate`	Stripe Tax-ID	`txr_1LPcLzAWeZvbCyjpzDA4qs1l`	Legt die `default_tax_rates` des Abonnements fest. Dies bestimmt auch die `default_tax_rates` der Rechnung für alle vom Abonnement in dieser Phase ausgestellten Rechnungen. Dieser Wert ist mit `automatic_tax` nicht kompatibel.
`backdate_start_date`	Zeitstempel im Epoch UNIX-Format	`1705753518`	Legt das `start_date` des erstellten Abonnements fest, das in der Vergangenheit sein muss. Wenn festgelegt, müssen Sie `none` für das `proration_behavior` angeben. Dadurch wird die Erstellung einer anteiligen Rechnung für den Zeitraum zwischen `backdate_start_date` und dem tatsächlichen `start_date` verhindert. Weitere Informationen finden Sie unter Rückdatierung kostenlos.
`days_until_due`	Ganze Zahl	`30`	Die Anzahl der Tage ab dem Zeitpunkt der Rechnungserstellung bis zur Fälligkeit. Dies ist erforderlich und nur für Rechnungen gültig, bei denen `collection_method` auf `send_invoice` festgelegt ist.
`cancel_at_period_end`	Boolean	`false`	Geben Sie `true` an, um ein Abonnement am Ende des Zeitraums zu kündigen.
`add_invoice_items.0.amount`	Anzahl	`19,99`	Eine positive Zahl. Verwenden Sie vollständige Werte mit Dezimalstellen (z. B. 21,50).
`add_invoice_items.0.product`	Stripe-Produkt-ID	`prod_PjfC3kWS58IoOX`	Die Kennung des Produkts, zu dem die Rechnung hinzugefügt werden soll.
`add_invoice_items.0.currency`	Zeichenfolge	`usd`	Aus drei Buchstaben bestehender ISO-Währungscode, in Kleinbuchstaben für eine unterstützte Währung.

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-Konten migrieren, sehen Sie sich das CSV-Beispiel an, bevor Sie eine CSV-Datei angeben und hochladen.

Eine CSV-Datei 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 im erforderlichen CSV-Format vorliegen. 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. Wenn Validierungsfehler auftreten, müssen Sie die Fehler beheben, um fortzufahren.

Hochgeladene Abonnements prüfen

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

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

Migrationsfortschritt	Beschreibung
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. Sie können keine geplanten Abonnements mit dem Migrations-Toolkit aktualisieren. Wenn Sie Ihre geplanten Abonnements aktualisieren möchten, können Sie entweder den Endpoint zum Aktualisieren aufrufen oder jedes Abonnement einzeln auf der Seite Abonnements des Dashboards 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 auf der Seite Abonnements des Dashboards einsehen. Nachdem die Migration live gegangen ist, empfehlen wir Ihnen, Ihre Abonnements ab der ersten Zahlung zu überwachen. Stellen Sie sicher, dass die Abbuchungstermine und -beträge für die migrierten Abonnements mit dem angegebenen start_date übereinstimmen. Kundinnen und Kunden können ihre Live-Abonnements im Kundenportal kündigen.
Abonnements überwachen	Nachdem die Migration live geschaltet wurde, überwachen Sie Ihre Abonnements auf Probleme mit Zahlungsmethoden. Überprüfen Sie beispielsweise Transaktionen 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

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

Wenn Sie Probleme mit den geplanten Abonnements feststellen, können Sie die Migration rückgängig machen und die geplanten Abonnements wiederherstellen. Das Dashboard zeigt einen Zeitstempel an, um anzugeben, 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. Um die Migration nach 10 Stunden abzubrechen, können Sie entweder den Endpoint zum Abbrechen aufrufen oder jedes Abonnement einzeln auf der Seite Abonnements des Dashboards kündigen.

Suchen Sie die Migration, die Sie abbrechen möchten, in Ihren Migrationen.
Klicken Sie im Dropdown-Menü auf Migration abbrechen.

OptionalMehrere Migrationen durchführen

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.

Außerdem finden Sie Beispiele für CSV-Dateien für gängige Use cases für Migrationen.

OptionalValidierungsfehler beheben

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_error, um die Fehler anzuzeigen.

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

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.

Migrationsszenarien

Sie können die Anwendungsszenarien für die Migration in diesem Abschnitt ggf. auf Ihre eigene Migration anwenden. Die Zeitstempel in diesen Beispielen sind im Unix-EPOCH-Format. Die Beispiele enthalten auch Testkunden- und Preis-IDs, die Sie in einer Sandbox verwenden können.

Sie können jede von Stripe bereitgestellte CSV-Vorlage (Basic, Artikel mit mehreren Preisen, Ad-hoc-Preisgestaltung) bei Bedarf mit einem dieser Beispiele kombinieren.

Abonnements mit verschiedenen Preismodellen migrieren

Sie können Abonnements mit Pauschalpreisen migrieren, zum Beispiel einen Basic-Plan für 100 USD pro Monat oder einen Advanced-Plan für 200 USD pro Monat. Diese Abonnements können einen oder mehrere Posten haben.

Beispiel 1 (Basic): Migrieren Sie ein monatliches Basisabonnement für 100 USD mit der Menge 2 ab dem 1. Januar. Das Abonnement wird automatisch mit der Standard-Zahlungsmethode belastet.

ATTRIBUT	Kundin/Kunde (erforderlich)	start_date (erforderlich)	Preis (erforderlich)	Menge	metadata.third_party_sub_id	automatic_tax	billing_cycle_anchor	Gutschein	trial_end	proration_behavior	collection_method	default_tax_rate	backdate_start_date	days_until_due	cancel_at_period_end	add_invoice_items.0.amount	add_invoice_items.0.product	add_invoice_items.0.currency
FELD	cus_xxxx1	1704067200	price_xxx1	2	subscription_1					keine	charge_automatically

Beispiel 2 (Artikel mit mehreren Preisen): Migrieren Sie die folgenden Abonnements ab dem 1. Januar, um sie automatisch mit der Standard-Zahlungsmethode zu belasten:

Ein Basic-Monatsabonnement über 100 USD mit der Menge 2
Ein Advanced-Monatsabonnement über 200 USD mit der Menge 1

ATTRIBUT	Kundin/Kunde (erforderlich)	start_date (erforderlich)	items.0.price (erforderlich)	items.0.quantity	items.1.price	items.1.quantity	metadata.third_party_sub_id	automatic_tax	billing_cycle_anchor	Gutschein	trial_end	proration_behavior	collection_method	default_tax_rate	backdate_start_date	days_until_due	cancel_at_period_end	add_invoice_items.0.amount	add_invoice_items.0.product	add_invoice_items.0.currency
FELD	cus_xxxx1	1704067200	price_xxx1	1	price_xxx2	subscription_1						keine	charge_automatically

Beispiel 3 (Basic): Migrieren Sie das folgende Abonnement ab dem 1. Januar, um es automatisch mit der Standard-Zahlungsmethode zu belasten:

Ein Basic-Monatsabonnement über 100 USD mit der Menge 2
Eine zusätzliche Gebühr für Ad-hoc-Rechnungen in Höhe von 20 USD

ATTRIBUT	Kundin/Kunde (erforderlich)	start_date (erforderlich)	Preis (erforderlich)	Menge	metadata.third_party_sub_id	automatic_tax	billing_cycle_anchor	Gutschein	trial_end	proration_behavior	collection_method	default_tax_rate	backdate_start_date	days_until_due	cancel_at_period_end	add_invoice_items.0.amount	add_invoice_items.0.product	add_invoice_items.0.currency
FELD	cus_xxxx1	1704067200	price_xxx1	2	subscription_1					keine	charge_automatically					50	prod_xxx1	USD

Sie können Abonnements auch mit Ad-hoc-Preisen migrieren, wenn Sie keine festen Preisbeträge haben.

Beispiel 4 (Ad-hoc-Preisgestaltung): Migrieren Sie das folgende Abonnement ab dem 1. Januar, um es automatisch mit der Standard-Zahlungsmethode zu belasten:

Ein Ad-hoc-Monatsabonnement in Höhe von 153 USD mit der Menge 1

ATTRIBUT	Kundin/Kunde (erforderlich)	start_date (erforderlich)	adhoc_items.0.amount (erforderlich)	adhoc_items.0.product	adhoc_items.0.interval	adhoc_items.0.currency	adhoc_items.0.quantity	metadata.third_party_sub_id	automatic_tax	billing_cycle_anchor	Gutschein	trial_end	proration_behavior	collection_method	default_tax_rate	backdate_start_date	days_until_due	cancel_at_period_end	add_invoice_items.0.amount	add_invoice_items.0.product	add_invoice_items.0.currency
FELD	cus_xxxx1	1704067200	price_xxx1	prod_xxx1	1	subscription_1						keine	charge_automatically

Abonnements mit verschiedenen Zahlungseinzugsmethoden migrieren

Sie können die Zahlung für die migrierten Abonnements entweder automatisch mit der standardmäßig gespeicherten Zahlungsmethode einziehen oder indem Sie eine Rechnung senden, die der Kunde/die Kundin bis zum Fälligkeitsdatum bezahlen kann.

Beispiel 1 (Basic): Migrieren Sie ein Jahresabonnement für 500 USD mit der Menge 1 ab dem 1. Januar, um es automatisch mit der Standard-Zahlungsmethode zu belasten.

ATTRIBUT	Kundin/Kunde (erforderlich)	start_date (erforderlich)	Preis (erforderlich)	Menge	metadata.third_party_sub_id	automatic_tax	billing_cycle_anchor	Gutschein	trial_end	proration_behavior	collection_method	default_tax_rate	backdate_start_date	days_until_due	cancel_at_period_end	add_invoice_items.0.amount	add_invoice_items.0.product	add_invoice_items.0.currency
FELD	cus_xxxx1	1704067200	price_xxx1	1	subscription_1					keine	charge_automatically

Beispiel 2 (Basic): Migrieren Sie ein Jahresabonnement im Wert von 500 USD mit der Menge 1 ab dem 1. Januar. Dieses Abonnement wird mit einer an den Kunden/die Kundin gesendeten Rechnung mit einer Fälligkeit von 30 Tagen abgerechnet.

ATTRIBUT	Kundin/Kunde (erforderlich)	start_date (erforderlich)	Preis (erforderlich)	Menge	metadata.third_party_sub_id	automatic_tax	billing_cycle_anchor	Gutschein	trial_end	proration_behavior	collection_method	default_tax_rate	backdate_start_date	days_until_due	cancel_at_period_end	add_invoice_items.0.amount	add_invoice_items.0.product	add_invoice_items.0.currency
FELD	cus_xxxx1	1704067200	price_xxx1	1	subscription_1					keine	send_invoice			30

Migration von Abonnements in unterschiedlichen Phasen des Abo-Servicezeitraums

Beispiel 1 (Basic): Migrieren Sie ein Abonnement, das verlängert werden soll. Migrieren Sie beispielsweise ein monatliches Abonnement über 100 USD mit dem Verlängerungsdatum 1. Januar. Das Abonnement verlängert sich am 1. jedes Monats.

Legen Sie das start_date auf das aktuelle Verlängerungsdatum fest, damit das Abonnement sofort belastet wird.
Setzen Sie billing_cycle_anchor auf das Datum des nächsten Verlängerungszyklus.
Setzen Sie proration_behavior auf none.

ATTRIBUT	Kundin/Kunde (erforderlich)	start_date (erforderlich)	Preis (erforderlich)	Menge	metadata.third_party_sub_id	automatic_tax	billing_cycle_anchor	Gutschein	trial_end	proration_behavior	collection_method	default_tax_rate	backdate_start_date	days_until_due	cancel_at_period_end	add_invoice_items.0.amount	add_invoice_items.0.product	add_invoice_items.0.currency
FELD	cus_xxxx1	1704067200	price_xxx1		subscription_1		1706745600			keine	charge_automatically

Beispiel 2 (Basic): Migration eines bezahlten Abos, das sich mitten in einem Rechnungsstellungszeitraum befindet. Zum Beispiel die Migration eines monatlichen Abos über 100 USD mit ursprünglichem Startdatum 25. Dezember. Das Migrationsdatum ist der 1. Januar und das Abo verlängert sich jeden Monat am 25.

Setzen Sie backdate_start_date auf das ursprüngliche Startdatum des Abonnements.
Setzen Sie billing_cycle_anchor auf das bevorstehende Verlängerungsdatum.
start_date auf das Migrationsdatum setzen.
Setzen Sie proration_behavior auf none, um eine erneute Belastung der Kundin/des Kunden zu vermeiden und das Abo bis zum nächsten Rechnungsstellungszeitraum im geplanten Zustand zu belassen.

ATTRIBUT	Kundin/Kunde (erforderlich)	start_date (erforderlich)	Preis (erforderlich)	Menge	metadata.third_party_sub_id	automatic_tax	billing_cycle_anchor	Gutschein	trial_end	proration_behavior	collection_method	default_tax_rate	backdate_start_date	days_until_due	cancel_at_period_end	add_invoice_items.0.amount	add_invoice_items.0.product	add_invoice_items.0.currency
FELD	cus_xxxx1	1704067200	price_xxx1		subscription_1		1706140800			keine	charge_automatically		1703462400

Beispiel 3 (Basic): Abonnements mit Testversionen migrieren. Migrieren Sie beispielsweise ein monatliches Basisabonnement über 100 USD, das am 1. Januar startet. Das Abonnement wird bis zum 31. Januar getestet. Nach Ablauf der Testphase wird das Abonnement automatisch mit der Standard-Zahlungsmethode belastet.

ATTRIBUT	Kundin/Kunde (erforderlich)	start_date (erforderlich)	Preis (erforderlich)	Menge	metadata.third_party_sub_id	automatic_tax	billing_cycle_anchor	Gutschein	trial_end	proration_behavior	collection_method	default_tax_rate	backdate_start_date	days_until_due	cancel_at_period_end	add_invoice_items.0.amount	add_invoice_items.0.product	add_invoice_items.0.currency
FELD	cus_xxxx1	1704067200	price_xxx1	1	subscription_1				1706659200	keine	charge_automatically		1703462400

Beispiel 4 (Basic): Migrieren von überfälligen Abonnements. Migrieren Sie beispielsweise ein monatliches Abonnement im Wert von 100 US-Dollar mit einem letzten Zyklusstartdatum am 25. Dezember, das nicht bezahlt wurde. Migrieren Sie diesen mittleren Zyklus ab dem 1. Januar mit einem Verlängerungsdatum am 25. eines jeden Monats. Dadurch wird eine anteilige Rechnung vom 1. Januar bis zum 25. Januar erstellt, für die Stripe versuchen kann, die Zahlung einzuziehen.

Um Abonnements zu migrieren, die sich in einem aktiven Zyklus befinden, aber im vorherigen System nicht bezahlt wurden, setzen Sie proration_behavior auf create_prorations, um sofort eine Rechnung zu erstellen und Zahlungen einzuziehen. Dies geht auch in den Dunning-Ablauf von Stripe ein, wenn die Zahlung noch unbezahlt ist.

ATTRIBUT	Kundin/Kunde (erforderlich)	start_date (erforderlich)	Preis (erforderlich)	Menge	metadata.third_party_sub_id	automatic_tax	billing_cycle_anchor	Gutschein	trial_end	proration_behavior	collection_method	default_tax_rate	backdate_start_date	days_until_due	cancel_at_period_end	add_invoice_items.0.amount	add_invoice_items.0.product	add_invoice_items.0.currency
FELD	cus_xxxx1	1704067200	price_xxx1	1	subscription_1		1706140800			create_prorations	charge_automatically		1703462400

Beispiel 5: Migrieren von Abonnements, die am Ende des Zyklus gekündigt werden müssen. Nach der Migration können Sie wählen, ob diese Abonnements belastet werden sollen oder nicht, basierend auf dem Migrationszeitpunkt (in der Mitte des Zyklus oder bei der Verlängerung).

Sie werden am Ende dieses Zeitraums gekündigt. Migrieren Sie beispielsweise ein monatliches Basisabonnement über 100 USD, das am 1. Januar startet. Dieses Abonnement wird am 31. Januar automatisch gekündigt.

ATTRIBUT	Kundin/Kunde (erforderlich)	start_date (erforderlich)	Preis (erforderlich)	Menge	metadata.third_party_sub_id	automatic_tax	billing_cycle_anchor	Gutschein	trial_end	proration_behavior	collection_method	default_tax_rate	backdate_start_date	days_until_due	cancel_at_period_end	add_invoice_items.0.amount	add_invoice_items.0.product	add_invoice_items.0.currency
FELD	cus_xxxx1	1704067200	price_xxx1	1	subscription_1		1706140800			keine	charge_automatically		1703462400			TRUE

Abonnements mit Steuern migrieren

Beispiel 1 (Basic): Migrieren Sie Abonnements, um Steuern automatisch zu berechnen, indem Sie Stripe Tax aktivieren. Migrieren Sie beispielsweise ein monatliches Abonnement über 100 USD ab dem 1. Januar mit aktiviertem Stripe Tax, um die Steuern automatisch zu berechnen.

Das Migrations-Toolkit überprüft, ob Sie Stripe Tax im Voraus aktiviert haben und ob Kunden/Kundinnen die erforderlichen Felder zur automatischen Berechnung der Steuer angegeben haben. Stellen Sie sicher, dass Ihre Kunden/Kundinnen vor der Migration die erforderlichen Informationen bereitstellen.

ATTRIBUT	Kundin/Kunde (erforderlich)	start_date (erforderlich)	Preis (erforderlich)	Menge	metadata.third_party_sub_id	automatic_tax	billing_cycle_anchor	Gutschein	trial_end	proration_behavior	collection_method	default_tax_rate	backdate_start_date	days_until_due	cancel_at_period_end	add_invoice_items.0.amount	add_invoice_items.0.product	add_invoice_items.0.currency
FELD	cus_xxxx1	1704067200	price_xxx1	1	subscription_1	TRUE				keine	charge_automatically

Beispiel 2 (Basic): Migrieren Sie Abonnements und berechnen Sie Steuern mit manuellen Steuersätzen. So migrieren Sie beispielsweise ein monatliches Basisabonnement über 100 USD ab dem 1. Januar, bei dem 10 % Steuern mit manuellen Steuersätzen erstellt werden:

Erstellen Sie eine manuelle Steuersatz über 10 % im Dashboard (Produktkatalog > Gutscheine).
Verwenden Sie die Steuersatz-ID in der CSV-Vorlage der Migration.

ATTRIBUT	Kundin/Kunde (erforderlich)	start_date (erforderlich)	Preis (erforderlich)	Menge	metadata.third_party_sub_id	automatic_tax	billing_cycle_anchor	Gutschein	trial_end	proration_behavior	collection_method	default_tax_rate	backdate_start_date	days_until_due	cancel_at_period_end	add_invoice_items.0.amount	add_invoice_items.0.product	add_invoice_items.0.currency
FELD	cus_xxx1	1704067200	price_xxx1	1	subscription_1	FALSE	1706140800			keine	charge_automatically	txr_xxx1

Beispiel 3 (Basis): Wenn Sie einen externen Steueranbieter wie Avalara oder Vertex verwenden:

Für migrierte Abonnements, bei denen die Steuer bereits berechnet wurde, lassen Sie sowohl automatic_tax als auch default_tax_rate in der CSV-Datei leer.

Nachdem die Abonnements migriert und live sind, folgen sie automatisch den Abläufen zur Steuerintegration, die Sie für neue Abonnements in Ihrer Billing-Integration eingerichtet haben.

Abonnements mit Rabatten migrieren

Das Migrations-Toolkit unterstützt nur einen Gutschein pro Abonnement.

Sie können Abonnements mit Rabatten migrieren, die nach der Migration angewendet werden. So migrieren Sie beispielsweise ein monatliches Abonnement im Wert von 100 USD ab dem 1. Januar mit einem dauerhaften Rabatt von 10 %:

Erstellen Sie einen Gutschein über 10 % im Dashboard (Produktkatalog > Gutscheine).
Verwenden Sie den Gutscheinnamen in der Migrations-CSV-Datei.

ATTRIBUT	Kundin/Kunde (erforderlich)	start_date (erforderlich)	Preis (erforderlich)	Menge	metadata.third_party_sub_id	automatic_tax	billing_cycle_anchor	Gutschein	trial_end	proration_behavior	collection_method	default_tax_rate	backdate_start_date	days_until_due	cancel_at_period_end	add_invoice_items.0.amount	add_invoice_items.0.product	add_invoice_items.0.currency
FELD	cus_xxxx1	1704067200	price_xxx1	1	subscription_1			sample_coupon		keine	charge_automatically

Abonnements innerhalb von Stripe-Konten migrieren

Die Schritte zur Migration von Abonnements von einem Stripe-Konto zu einem anderen sind die gleichen wie bei der Migration von einem Drittanbietersystem. Verwenden Sie das Billing-Migrations-Toolkit, um die Abonnementdaten für Ihre CSV-Datei aus Ihrem alten Stripe-Konto zu exportieren.

So erstellen Sie eine Migrations-CSV-Datei für eine Stripe-zu-Stripe-Migration:

Exportieren Sie die Abonnements aus dem alten Stripe-Konto über das Dashboard.
Verwenden Sie das folgende CSV-Beispiel als Referenz, um Felder zwischen den alten und neuen Stripe-Konten zuzuordnen.

ATTRIBUT	Kundin/Kunde (erforderlich)	start_date (erforderlich)	Preis (erforderlich)	Menge	metadata.old_Stripe_sub_id	automatic_tax	billing_cycle_anchor	Gutschein	trial_end	proration_behavior	collection_method	default_tax_rate	backdate_start_date	days_until_due	cancel_at_period_end
FELD	Exportfeld: Kunen-ID (aus vorherigem Kontoexport)	Exportfeld: Aktuelles Ende des Zeitraums UTC (aus vorherigem Kontoexport)	Die jeweilige Preis-ID auf dem neuen Konto	Exportfeld: Menge (aus vorherigem Kontoexport)	Exportfeld: ID (aus vorherigem Kontoexport)	TRUE, wenn Stripe-Steuern in neuem Konto verwendet wird, sonst FALSE	Das zukünftige Rechnungsdatum auf dem neuen Konto	Der jeweilige Gutschein auf dem neuen Konto, falls vorhanden	Der jeweilige Testzeitraum auf dem neuen Konto, falls vorhanden	`create_prorations` bei anteiliger Rechnung, sonst `none`	`charge_automatically` oder `send_invoice`	Der jeweilige Steuersatz auf dem neuen Konto, falls vorhanden	Exportfeld: Startdatum UTC (aus vorherigem Kontoexport)	Geben Sie an, ob `send_invoice` als Inkassomethode verwendet wird	Geben Sie an, ob ein Abonnement zum Ende des Zeitraums gekündigt werden soll

Abonnements mit mehreren Phasen migrieren

Das Migrations-Toolkit unterstützt nicht das direkte Hinzufügen mehrerer Phasen zu einem Abonnement. Wir empfehlen die folgende Vorgehensweise:

Verwenden Sie das Migrations-Toolkit, um die Anfangsphase des Abonnements zu migrieren.
Fügen Sie nach der Migration die zusätzlichen Phasen zu den migrierten Abonnementzeitplänen hinzu. Rufen Sie dazu den Update-Endpoint auf oder verwenden Sie das Stripe Subscriptions-Dashboard.
Passen Sie das start_date der Migration so an, dass zwischen den geplanten und den Live-Statusänderungen genügend Zeit bleibt. So können Sie die Phasenaktualisierungen vornehmen, bevor die Abonnements live gehen.

CSV-Referenz

Für das Migrations-Toolkit müssen Sie eine CSV-Datei hochladen, die bestimmte Informationen in den korrekten Feldern enthält.

CSV-Voraussetzungen

Bevor Sie eine CSV-Datei erstellen oder herunterladen, müssen Sie sicherstellen, dass Sie Zugriff auf die folgenden Informationen haben:

Customer-Objekt	Alle Kunden müssen über eine Standard-Zahlungsmethode verfügen. Ohne eine Standard-Zahlungsmethode schlagen zukünftige Abonnementzahlungen fehl. Wenn Sie nach der Migration Ihrer Daten keine Standard-Zahlungsmethode für Ihre Kunden festgelegt haben, haben Sie zwei Möglichkeiten: Holen Sie die Zustimmung des Nutzers/der Nutzerin ein oder verlassen Sie sich auf sein/ihr früheres Zahlungsverhalten, um die Standard-Zahlungsmethode pro Kunde/Kundin festzulegen. Verwenden Sie dieses bereitgestellte Skript, um die neueste Zahlungsmethode an Ihre Kunden/Kundinnen anzuhängen und zur Standardmethode zu machen.
Automatische Steuer	Wenn Sie Stripe Tax verwenden (wenn Sie automatische Steuern auf „true“ festgelegt haben), müssen alle Kundinnen und Kunden entweder Adressen oder Postleitzahlen (oder beides) pro Land angeben. Stripe benötigt diese Informationen, um die Steuern für die angegebenen Abonnements zu berechnen.
collection_method	Wenn Sie für Ihre Abonnements die Zahlungsmethode `send_invoice` verwenden: Fügen Sie den erforderlichen Kundinnen/Kunden E-Mail-Adressen hinzu. Fügen Sie den Parameter days_until_due in der Migrations-CSV-Datei hinzu, um die Gültigkeit der Rechnungen für jede Kundin/jeden Kunden anzugeben.
Daten	Um ein genaues Timing zu gewährleisten, achten Sie besonders auf die Zeitzonen, wenn Sie Epochen-Datumsformate für Ihre Migrations-CSV-Datei erstellen. Legen Sie für das Toolkit das start_date mit einem Spielraum von mindestens 24 Stunden vor dem CSV-Uploadzeitpunkt fest. Wir erstellen einen Abonnementplan, damit Sie diese Extrazeit erhalten, um die Richtigkeit zu bestätigen und zu überprüfen. Wenn das Startdatum beginnt, wechselt das Abonnement vom geplanten Start in den Live-Status.
Gutscheine	Wenn der Abo-Zeitplan oder das Abonnement über einen Abrechnungszyklusanker in der Zukunft verfügt und `proration_behavior` auf `none` gesetzt ist, wird der Gutschein durch das Aktualisieren dieser Objekte aufgehoben. Wenden Sie den Gutschein erneut an, wenn Sie den Abonnementplan oder das Abonnement aktualisieren. So migrieren Sie ein Abonnement mit laufendem `discount_behavior`: Legen Sie eine zukünftige Phase fest, in der der Gutschein zum richtigen Datum entfernt wird, anstatt auf ein Ablaufen zu warten. Erstellen Sie einen Gutschein für jedes Abonnement, wobei die Dauer für jedes Abonnement unterschiedlich ist, damit sie alle korrekt ablaufen.
Stripe-zu-Stripe-Migration	Nutzer/innen können Abonnements innerhalb von Stripe-Konten migrieren. Sie müssen Kunden-IDs und Preis-IDs (und gegebenenfalls auch Gutschrift-IDs und Steuer-IDs) in die Vorlage eingeben, die Ihrem Stripe-Zielkonto zugeordnet ist, und nicht Ihrem Stripe-Quellkonto. Das Migrations-Tool generiert einen Fehler, wenn Sie IDs eingeben, die Ihrem Quellkonto zugeordnet sind.

Vollständige CSV-Spezifikation

Attribut	Typ	Beschreibung
`customer` (erforderlich)	Stripe-Kunden-ID	Die Kennung des Kunden/der Kundin, für den/die das Abonnement erstellt werden soll.
`start_date` (erforderlich)	Zeitstempel im Epoch UNIX-Format	Legt fest, wann das Abonnement erstellt wird. Sie müssen einen Wert angeben, der 24 Stunden (oder mehr) in der Zukunft liegt. In einer Sandbox können Sie diese Einstellung auf 1 Stunde in der Zukunft festlegen.
`price` (erforderlich)	Stripe-Preis-ID	Muss ein wiederkehrender Preis sein. Wenn Sie mehrere Artikel migrieren, verwenden Sie stattdessen das Format `items.x.{price, quantity}`. Ad-hoc-Preise werden auch mit `adhoc_items.x.{amount, interval, product, currency}` unterstützt.
`quantity`	Anzahl	Bestimmt die Menge eines Abonnements. Standardmäßig gilt jedes Abonnement für ein Produkt, aber Stripe können Sie einem Kunden/einer Kundin mehrere Mengen eines Artikels zuweisen.
`items.x.price` (erforderlich)	Stripe-Preis-ID	Die ID des Preisobjekts. Muss ein wiederkehrender Preis sein.
`items.x.quantity`	Anzahl	Bestimmt die Menge eines Abonnements. Standardmäßig gilt jedes Abonnement für ein Produkt, aber Stripe können Sie einem Kunden/einer Kundin mehrere Mengen eines Artikels zuweisen.
`adhoc_items.x.amount` (erforderlich)	Anzahl	Eine positive Zahl. Verwenden Sie vollständige Werte mit Dezimalstellen (z. B. 21,50).
`adhoc_items.x.product` (erforderlich)	Stripe-Produkt-ID	Die Kennung des Produkts, das zum Ad-hoc-Preis gehört.
`adhoc_items.x.interval` (erforderlich)	`day`, `week`, `month` oder `year`	Die Abrechnungshäufigkeit.
`adhoc_items.x.currency` (erforderlich)	Zeichenfolge	Aus drei Buchstaben bestehender ISO-Währungscode, in Kleinbuchstaben für eine unterstützte Währung.
`adhoc_items.x.quantity`	Anzahl	Bestimmt die Menge eines Abonnements. Standardmäßig gilt jedes Abonnement für ein Produkt, aber Stripe können Sie einem Kunden/einer Kundin mehrere Mengen eines Artikels zuweisen.
`metadata_source`	Zeichenfolge	Bei einer Stripe-zu-Stripe-Migration geben Sie `internal:Stripe` ein.
`metadata_*`	Zeichenfolge	Hängen Sie diese Schlüsselwertpaare an ein Objekt an. Dies ist nützlich, um zusätzliche Informationen über das Objekt in einem strukturierten Format zu speichern.
`automatic_tax`	Boolean	Geben Sie `true` an, um die automatischen Steuereinstellungen von Stripe Tax.
`coupon`	Stripe-Gutschein-ID	Die Kennung des Gutscheins, der auf dieses Abonnement angewendet werden soll.
`currency`	Zeichenfolge	Dreistelliger ISO-Währungscode in Kleinbuchstaben. Muss eine unterstützte Währung sein. Wird für die Währungsauswahl mit Preisen in mehreren Währungen verwendet.
`trial_end`	Zeitstempel	Setzt die Phase auf „Test“ vom Startdatum bis zum `trial_end`-Datum. Sie müssen einen Wert angeben, der vor dem Enddatum des Zyklus/Phase liegt, und Sie können ihn nicht mit der Testversion kombinieren.
`proration_behavior`	`create_prorations` oder `none`	Legt fest, ob das Abonnement nach der Migration anteilmäßige Verrechnungen erstellt. Der Standardwert ist `create_prorations`.
`collection_method`	`charge_automatically` oder `send_invoice`	Bei automatischer Abrechnung versucht Stripe, das zugrunde liegende Abo am Ende jedes Rechnungsstellungszeitraums mit der Standard-Zahlungsmethode der Kundin/des Kunden zu belasten. Der Standardwert ist `charge_automatically`. Beim Versand einer Rechnung sendet Stripe Ihrer Kundin/Ihrem Kunden eine E-Mail mit Zahlungsanweisungen und markiert das Abo als aktiv. Bei Verwendung von `send_invoice` müssen Sie `days_until_due` festlegen.
`default_tax_rate`	Stripe Tax-ID	Legt die `default_tax_rates` des Abonnements fest. Dies bestimmt auch die `default_tax_rates` der Rechnung für alle vom Abonnement in dieser Phase ausgestellten Rechnungen. Dieser Wert ist mit `automatic_tax` nicht kompatibel.
`backdate_start_date`	Zeitstempel im Epoch UNIX-Format	Legt das `start_date` des erstellten Abonnements fest, das in der Vergangenheit sein muss. Wenn festgelegt, müssen Sie `none` für das `proration_behavior` angeben. Dadurch wird die Erstellung einer anteiligen Rechnung für den Zeitraum zwischen `backdate_start_date` und dem tatsächlichen `start_date` verhindert. Weitere Informationen finden Sie unter Rückdatierung kostenlos.
`billing_cycle_anchor`	Zeitstempel	Legt die zukünftigen Daten fest, wann das Abonnement dem Kunden/der Kundin in Rechnung gestellt werden soll.
`days_until_due`	Ganze Zahl	Die Anzahl der Tage ab dem Zeitpunkt der Rechnungserstellung bis zur Fälligkeit. Dies ist erforderlich und nur für Rechnungen gültig, bei denen `collection_method` auf `send_invoice` festgelegt ist.
`cancel_at_period_end`	Boolean	Geben Sie `true` an, um ein Abonnement am Ende des Zeitraums zu kündigen.

Siehe auch

Abonnements mithilfe der Stripe-APIs migrieren