Abonnements mithilfe der Stripe-APIs zu Stripe Billing migrieren
Erfahren Sie, wie Sie Ihre bestehenden Abonnements mithilfe der Stripe-APIs zu Stripe migrieren.
So migrieren Sie Ihre bestehenden Abonnements von einem Drittanbieter, einem internen System oder einem vorhandenen Stripe-Konto mithilfe der Stripe-APIs zu Stripe Billing.
Bevor Sie beginnen![](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. Diese Voraussetzung ist vor dem Import von Abonnements in Stripe nur einmal erforderlich und Sie müssen sie für zukünftige Migrationen nicht wiederholen.
- Fordern Sie einen PAN-Datenimport von Ihrem aktuellen Abwickler an. Wenn die Daten innerhalb von Stripe migriert werden, ist dies nicht erforderlich, da Stripe bereits die Zahlungen für Sie abwickelt.
Ältere Produkte und Preise verwalten![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Wenn Sie ältere Preismodelle haben, die Sie weiterhin in Stripe unterstützen müssen, erstellen Sie ein Platzhalterprodukt, wie z. B. Legacy plan
. Hier ist ein Beispiel:
Wenn Sie Abonnements mit älteren Plänen aktualisieren müssen, übergeben Sie die Preise nach Bedarf unter Verwendung von items.
. Dadurch werden alle bestehenden alten Preise überschrieben. Weitere Informationen finden Sie unter variable Preise.
Abonnements importieren![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Nachdem Sie Ihre Kunden/Kundinnen importiert und ein Preismodell erstellt haben, können Sie mit dem Import Ihrer Abonnements starten. Es sollte möglich sein, Abonnementdaten von Drittsystemen über deren Nutzeroberfläche oder API zu exportieren. Kontaktieren Sie Ihren Abonnementanbieter, wenn dieser die Option über keine der beiden Schnittstellen bereitstellt.
Verwenden Sie zum Importieren von Abonnements Ihre Kundenliste, um jeweils die entsprechenden Abonnements zu erstellen. Wenn beispielsweise ein Abonnent/eine Abonnentin in Ihrem alten Modell über ein monatliches Basic
-Abonnement verfügt, verwenden Sie den mit dieser Preisstufe verknüpften monatlich wiederkehrenden Preis, wenn Sie das Abonnement in Stripe erstellen.
Quelldaten müssen mit Stripe kompatibel sein![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Stellen Sie vor dem Import von Abonnements in Stripe sicher, dass alle Ihre Quelldaten mit dem erwarteten Format von Stripe kompatibel sind.
Wichtige Felder für die Migration von Abonnements![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Wenn Sie relevante Abonnementdaten in Ihrer nutzerdefinierten Integration verwenden, die Stripe nicht ebenfalls verwendet, können Sie Ihre Daten auf das Feld metadata
der von Ihnen in Stripe erstellten Abonnements anwenden. In der folgenden Tabelle werden andere wichtige Felder beschrieben, die beim Importieren von Abonnements berücksichtigt werden müssen.
Feld | Beschreibung |
---|---|
Kundin/Kunde | Stellen Sie sicher, dass die Kunden-ID aus Ihren Quelldaten ordnungsgemäß der neuen Kunden-ID in Stripe zugeordnet wurde. |
phases.items.price | Stellen Sie sicher, dass die Preis-ID aus Ihren Quelldaten der neuen Preis-ID in Stripe zugeordnet wurde. |
current_phase.start_date | Achten Sie darauf, dass der Abonnementzeitplan, den Sie in Stripe angeben, mit Ihren ursprünglichen Quelldaten übereinstimmt und deren Kontinuität beibehält. Wenn einer Kundin oder einem Kunden beispielsweise noch 6 Monate eines Jahresabonnements in Ihrem Quellsystem verbleiben, stellen Sie sicher, dass billing_ und start_ die korrekte Laufzeit in der Zyklusmitte widerspiegeln. |
Drittanbieter-Metadaten | Importieren Sie alle zusätzlichen Datenfelder aus Ihren Quelldaten. Diese können Produktnamen, Plannamen und Anwendungs-IDs von Drittanbietern umfassen. |
Steuereinstellungen | Geben Sie sämtliche Steuer-IDs, Umsatzsteuer-IDs oder andere Steuerinformationen an. |
Ältere Preise vorbereiten![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Wenn Sie Platzhalter für ältere Preise erstellt haben, müssen Sie diese Preise den Abonnements und Kunden/Kundinnen zuordnen, die Sie importieren. Verwenden Sie für jedes Abonnement mit einem alten Preis den Parameter price_data der Subscriptions API, um Informationen über den Preis und das Abonnement zu übergeben. Verpflichtend sind folgende Felder:
Parameter | Beschreibung |
---|---|
Währung | Währung des Preises im ISO-Format mit drei Buchstaben. |
Produkt | ID des Platzhalterprodukts. Diese kann für alle alten Preise verwendet werden. |
wiederkehrend | Informationen über Betrag und Häufigkeit des wiederkehrenden Preises. |
recurring.interval | Häufigkeit des Intervalls – day , week , month oder year . |
recurring.interval_count | Die Anzahl der Intervalle zwischen Abrechnungen. Wenn Sie beispielsweise interval=day und interval_ festlegen, bedeutet dies, dass der/die Kund/in alle 30 Tage abgerechnet wird. Das höchste Intervall beträgt 1 Jahr (1 Jahr, 12 Monate oder 52 Wochen). |
recurring.unit_amount_decimal | Dasselbe wie unit_amount mit der zusätzlichen Möglichkeit, detailliertere Dezimalbeträge in Cent anzugeben, auf bis zu 12 Dezimalstellen. Sie können jeweils nur unit_ oder unit_ festlegen. |
Abonnementdaten in Stripe importieren![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Nachdem Sie Ihre Quelldaten aufbereitet haben, können Sie damit beginnen, Abonnements in Stripe zu importieren.
Test-Modus![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Verwenden Sie den Test-Modus, um den Importvorgang des Preismodells mindestens einmal zu durchlaufen, bevor Sie diesen im Live-Modus ausführen. Sie müssen Ihr Skript neu zuordnen:
- Wenn Sie die Daten im Testmodus löschen und den Import erneut ausführen.
- Wenn Sie in den Live-Modus wechseln, weil die Preis-IDs im Test- und im Live-Modus unterschiedlich sind.
Im Test-Modus können Sie Test-Uhren verwenden, um das Fortschreiten der Abonnements im Zeitverlauf zu simulieren. Auf diese Weise können Sie sehen, wie die migrierten Abonnements in Produktion funktionieren.
Abonnements erstellen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Während Abonnements mit der Subscription API erstellt werden können, empfehlen wir die Verwendung der Subscription Schedules API. Mit dieser API können Sie Abonnements so planen, dass sie zu einem Zeitpunkt in der Zukunft starten. Dies ist beispielsweise die einzige Möglichkeit, monatliche Abonnements mehr als 30 Tage im Voraus zu starten. Bei Nutzung dieser Option können Sie außerdem den Import überprüfen, bevor Sie mit der Rechnungsstellung an Ihre Kunden/Kundinnen im Produktionsmodus beginnen.
Darüber hinaus bietet die Subscription Schedules API phases
, die viel mehr Flexibilität beim Definieren von Einstellungen wie Steuerverhalten, Einzugsmethode und Gutscheinverwendung in detaillierteren Intervallen bieten. Sie können auch unterschiedliche Verhaltensweisen für unterschiedliche Intervalle definieren. So könnten Sie beispielsweise einen Gutschein nur für die ersten 3 Monate eines Jahresabonnements einlösen.
So erstellen Sie Abonnements, die am starten.
Migration bestätigen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Nachdem Sie Ihre Abonnements importiert haben, bestätigen Sie mithilfe der API, dass die Abonnements in Stripe existieren.
Verwenden Sie die API Abonnements eintragen, um alle Abonnements in Stripe anzuzeigen. Sie können den Parameter erstellt übergeben, um nach kürzlich erstellten Abonnements zu filtern.