Abonnements mithilfe der Stripe-APIs zu Stripe Billing migrieren

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:

curl https://api.stripe.com/v1/products \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d id={{NEW_PRODUCT_ID}} \
  -d name="Legacy plan" \
  -d description="Imported legacy plan from source system" \
  -d "metadata[OLD_PRODUCT_ID]"={{OLD_PRODUCT_ID}}

Wenn Sie Abonnements mit älteren Plänen aktualisieren müssen, übergeben Sie die Preise nach Bedarf mithilfe von items.price_data. Dadurch werden alle bestehenden alten Preise überschrieben. Weitere Informationen finden Sie unter variable Preise.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer={{CUSTOMER_ID}} \
  -d "items[0][price_data][currency]"=USD \
  -d "items[0][price_data][product]"={{PRODUCT_ID}} \
  -d "items[0][price_data][recurring][interval]"=month \
  -d "items[0][price_data][recurring][interval_count]"=3 \
  -d "items[0][price_data][unit_amount]"=1000 \
  -d "items[0][quantity]"=1

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

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

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.

Ältere Preise vorbereiten

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:

Abonnementdaten in Stripe importieren

Nachdem Sie Ihre Quelldaten aufbereitet haben, können Sie damit beginnen, Abonnements in Stripe zu importieren.

Tests

Verwenden Sie eine Sandbox, 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 in einer Sandbox löschen und den Import erneut ausführen.
• Wenn Sie in den Live-Modus wechseln, weil die Preis-IDs in einer Sandbox und im Live-Modus unterschiedlich sind.

In einer Sandbox 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

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 1. Juni 2022 um 00:00 UTC starten.

curl https://api.stripe.com/v1/subscription_schedules \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "default_settings[billing_cycle_anchor]"=phase_start \
  -d "phases[0][items][0][price]"=
{{PRICE_ID}} \
  -d start_date=1654066801

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.

curl -G https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "created[gt]"=1647294709