Toolkit CSV-Referenz
Befolgen Sie die Best Practices für eine erfolgreiche Migration Ihrer Abonnements mit dem Billing-Toolkit ohne Code.
Verwenden Sie diese Anleitung, um Ihre CSV-Datei im Billing-Migrations-Toolkit anzugeben. In den folgenden Beispielen sind alle Zeitstempel im Unix-Epochenformat. Wir bieten auch Testkunden- und Preis-IDs an, die Sie im Testmodus verwenden können.
CSV-Voraussetzungen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Bevor Sie eine CSV-Datei erstellen oder herunterladen, sollten Sie Folgendes beachten:
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:
|
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_ verwenden:
|
Daten |
|
Gutscheine |
|
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. |
Migrationsszenarien![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Sie können die folgenden Migrationsszenarien auf Ihre eigene Migration anwenden, falls zutreffend:
- Abonnements mit Rabatten unterschiedlichen Preismodellen migrieren
- Abonnements mit verschiedenen Zahlungsmethoden migrieren
- Migrieren von Abonnements in verschiedenen Phasen des Abonnementzyklus
- Abonnements mit Steuern migrieren
- Abonnements mit Rabatten migrieren
- Abonnements innerhalb von Stripe migrieren
- Abonnements mit mehreren Phasen migrieren
Sie können jede von Stripe bereitgestellte CSV-Vorlage (Basis, Artikel mit mehreren Preisen, Ad-hoc-Preisgestaltung) bei Bedarf mit einem der folgenden Beispiele kombinieren.
Migrieren von Abonnements mit verschiedenen Preismodellen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
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 eines Basic-Monatsabonnements über 100 USD mit der Menge 2, beginnend am 1. Januar 2024. Dieses Abonnement wird mit der Standard-Zahlungsmethode automatisch 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 | 2 | subscription_1 | keine | charge_automatically |
Beispiel 2 (Artikel mit mehreren Preisen): Migrieren Sie die folgenden Abonnements ab dem 1. Januar 2024, 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 (Basis): Migrieren Sie das folgende Abonnement ab dem 1. Januar 2024, 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 2024, 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 Zahlungsmethoden migrieren![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
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 eines Jahresabonnements über 500 USD mit der Menge 1, beginnend am 1. Januar 2024. Dieses Abonnement wird mit der Standard-Zahlungsmethode automatisch 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 | charge_automatically |
Beispiel 2 (Basic): Migrieren eines Jahresabonnements über 500 USD mit der Menge 1, beginnend am 1. Januar 2024. Dieses Abonnement wird über eine an den Kunden/die Kundin gesendete Rechnung mit einem Fälligkeitsdatum 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 |
Migrieren von Abonnements in verschiedenen Phasen des Abonnementzyklus![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Beispiel 1 (Basic): Migrieren eines Abonnements, dessen Verlängerung fällig ist. Migrieren Sie beispielsweise ein monatliches Abonnement im Wert von 100 USD mit einem Verlängerungsdatum am 1. Januar 2024. Das Abonnement wird am 1. eines jeden Monats verlängert.
- Legen Sie das
start_
auf das aktuelle Verlängerungsdatum fest, damit das Abonnement sofort belastet wird.date - Setzen Sie
billing_
auf das Datum des nächsten Verlängerungszyklus.cycle_ anchor - Setzen Sie
proration_
aufbehavior 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): Migrieren eines kostenpflichtigen Abonnements, das sich in der Mitte eines Abrechnungszyklus befindet. Migrieren Sie beispielsweise ein Monatsabonnement in Höhe von 100 USD mit einem ursprünglichen Startdatum am 25. Dezember. Das Migrationsdatum ist der 1. Januar und das Abonnement verlängert sich am 25. eines jeden Monats.
- Setzen Sie
backdate_
auf das ursprüngliche Startdatum des Abonnements.start_ date - Setzen Sie
billing_
auf das bevorstehende Verlängerungsdatum.cycle_ anchor start_
auf das Migrationsdatum setzen.date - Setzen Sie
proration_
aufbehavior none
, um zu vermeiden, dass der Kunde/die Kundin erneut belastet wird, und halten Sie das Abonnement bis zum nächsten Abrechnungszeitraum in einem geplanten Zustand.
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): Migrieren von Abonnements mit Testversionen. Migrieren Sie beispielsweise ein monatliches Basisabonnement in Höhe von 100 US-Dollar ab dem 1. Januar 2024. Das Abonnement wird bis zum 31. Januar 2024 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_
auf create_
, 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 in Höhe von 100 US-Dollar ab dem 1. Januar 2024. Dieses Abonnement wird automatisch am 31. Januar 2024 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![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Beispiel 1 (Basic): Migrieren Sie Abonnements, um die Steuer automatisch zu berechnen, indem Sie Stripe Tax aktivieren. Migrieren Sie zum Beispiel ein 100 USD-Monatsabonnement ab dem 1. Januar 2024, wobei Stripe Tax aktiviert ist, um die Steuer 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 (Basis): Migrieren Sie Abonnements und berechnen Sie Steuern mithilfe von manuellen Steuersätzen. So migrieren Sie beispielsweise ein monatliches Basisabonnement in Höhe von 100 USD ab dem 1. Januar 2024 mit einer Steuer von 10 %, die mit manuellen Steuersätzen erstellt wurde:
- 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_
als auch default_
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![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Das Migrations-Toolkit unterstützt derzeit nur einen Gutschein pro Abonnement.
Beispiel 1 (Basis): Sie können Abonnements mit Rabatten migrieren, die nach der Migration angewendet werden. So migrieren Sie beispielsweise ein 100 USD-Monatsabonnement ab dem 1. Januar 2024 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 migrieren![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
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 Abonnements zu migrieren. Sie müssen die Abonnementdaten für Ihre CSV-Datei aus Ihrem alten Stripe-Konto exportieren.
Beispiel 1 (Basis): So erstellen Sie eine Migrations-CSV 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_ bei anteiliger Rechnung, sonst none | charge_ oder send_ | Der jeweilige Steuersatz auf dem neuen Konto, falls vorhanden | Exportfeld: Startdatum UTC (aus vorherigem Kontoexport) | Geben Sie an, ob send_ als Inkassomethode verwendet wird | Geben Sie an, ob ein Abonnement zum Ende des Zeitraums gekündigt werden soll |
Abonnements mit mehreren Phasen migrieren![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
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_
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.date
Vollständige CSV-Spezifikation![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Attribut | Typ | Beschreibung |
---|---|---|
customer (erforderlich) | Stripe-Kunden-ID | Die Kennung des Kunden/der Kundin, für den/die das Abonnement erstellt werden soll. |
start_ (erforderlich) | Zeitstempel im Epoch UNIX-Format | Legt fest, wann das Abonnement erstellt werden soll. Sie müssen einen Wert angeben, der 24 Stunden (oder weiter) in der Zukunft liegt. Im Testmodus können Sie dies auf 1 Stunde in der Zukunft einstellen. |
price (erforderlich) | Stripe-Preis-ID | Muss ein wiederkehrender Preis sein. Wenn Sie mehrere Artikel migrieren, verwenden Sie stattdessen das Format items. . Ad-hoc-Preise werden auch mit adhoc_ unterstützt. |
quantity | Nummer | 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. (erforderlich) | Stripe-Preis-ID | Die ID des Preisobjekts. Muss ein wiederkehrender Preis sein. |
items. | Nummer | 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_ (erforderlich) | Ganzzahl | Eine positive ganze Zahl in Cent (oder 0 für einen kostenlosen Preis). Weitere Informationen finden Sie unter Abonnement erstellen. |
adhoc_ (erforderlich) | Stripe-Produkt-ID | Die Kennung des Produkts, das zum Ad-hoc-Preis gehört. |
adhoc_ (erforderlich) | day , week , month oder year | Die Abrechnungshäufigkeit. |
adhoc_ (erforderlich) | Zeichenfolge | Aus drei Buchstaben bestehender ISO-Währungscode, in Kleinbuchstaben für eine unterstützte Währung. |
adhoc_ | Nummer | 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 | 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_ | Boolesch | Geben Sie true an, um die automatischen Steuereinstellungen von Stripe Tax zu verwenden. |
coupon | Stripe-Gutschein-ID | Die Kennung des Gutscheins, der auf dieses Abonnement angewendet werden soll. |
trial_ | Zeitstempel | Setzt die Phase auf „Test“ vom Startdatum bis zum trial_ -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_ | create_ oder none | Legt fest, ob das Abonnement nach der Migration anteilmäßige Verrechnungen erstellt. Der Standardwert ist create_ . |
collection_ | charge_ oder send_ | Bei der automatischen Abrechnung versucht Stripe, das zugrunde liegende Abonnement am Ende jedes Abrechnungszyklus mit der dem Kunden zugeordneten Standardquelle zu bezahlen. Der Standardwert ist charge_ . Beim Senden einer Rechnung sendet Stripe Ihrem Kunden eine Rechnung mit Zahlungsanweisungen per E-Mail und markiert das Abonnement als aktiv. Wenn Sie send_ verwenden, müssen Sie days_ festlegen. |
default_ | Stripe Tax-ID | Legt die default_ des Abonnements fest. Dies bestimmt auch die default_ der Rechnung für alle vom Abonnement in dieser Phase ausgestellten Rechnungen. Dieser Wert ist mit automatic_ nicht kompatibel. |
backdate_ | Zeitstempel im Epoch UNIX-Format | Legt das start_ des erstellten Abonnements fest, das in der Vergangenheit sein muss. Wenn festgelegt, müssen Sie none für das proration_ angeben. Dadurch wird die Erstellung einer anteiligen Rechnung für den Zeitraum zwischen backdate_ und dem tatsächlichen start_ verhindert. Weitere Informationen finden Sie unter Rückdatierung kostenlos. |
billing_ | Zeitstempel | Legt die zukünftigen Daten fest, wann das Abonnement dem Kunden/der Kundin in Rechnung gestellt werden soll. |
days_ | Ganzzahl | 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_ auf send_ festgelegt ist. |
cancel_ | Boolesch | Geben Sie true an, um ein Abonnement am Ende des Zeitraums zu kündigen. |