Abonnements mit mehreren Produkten
Erstellen Sie Abonnements mit mehreren Produkten, die alle in einer Rechnung abgerechnet werden.
Wenn Sie mehrere Produkte anbieten oder unterschiedliche Beträge für das gleiche Produkt berechnen möchten, können Sie einem Abonnement mehrere Produkte zuordnen. Für jeden Abrechnungszeitraum wird eine Rechnung mit den einzelnen Preisen erstellt. Somit ist nur eine Zahlung für diese Rechnung erforderlich, wodurch Ihre Kosten und die Zahl der Abbuchungen bei Ihren Kund/innen sinken.
Abonnements mit mehreren Produkten erstellen
Erstellen Sie Abonnements für mehrere Produkte für Kund/innen mit dem Parameter items. Geben Sie für jedes Produkt den price und optional eine quantity an (wenn ein anderer Wert als 1 verwendet wird):
Die Antwort enthält eine Auflistung aller Abonnement-Artikel, Preise und Mengen:
{ "id": "sub_CZEpS1Zt9QLxdo", "object": "subscription", ... "items": { "object": "list", "data": [ { "id": "si_H1yPnAVzP9vDRW", "object": "subscription_item", "billing_thresholds": null, "created": 1585939321, "metadata": { }, "price": { "id": "price_H1c8v1liEvrfcd", "object": "price", "active": true, "billing_scheme": "per_unit", "created": 1585856460, "currency": "usd", "livemode": false, "lookup_key": null, "metadata": { }, "nickname": null, "product": "prod_H1c7exjJHbC4sr", "recurring": { "interval": "month", "interval_count": 1, "trial_period_days": null, "usage_type": "licensed" }, "tiers": null, "tiers_mode": null, "transform_quantity": null, "type": "recurring", "unit_amount": 1000, "unit_amount_decimal": "1000" }, "quantity": 1, "subscription": "sub_H1yPRslJXa4TUt", "tax_rates": [ ] },
Abrechnungszeiträume mit mehreren Preisen
Bei herkömmlichen Preisen, bei denen ein fester Betrag für ein Intervall berechnet wird, erfolgt die Abrechnung zu Beginn eines Abrechnungszyklus. Der Kunde/die Kundin zahlt mit jeder Rechnung effektiv für das nächste Dienstleistungsintervall. Bei der nutzungsbasierten Abrechnung variiert der von Kundinnen/Kunden zu zahlende Betrag je nach Verbrauch während des Abrechnungszyklus, d. h. die Kundinnen/Kunden zahlen am Ende für ihre Nutzungsmenge.
Wenn in einem Abonnement ein Festpreis mit einer nutzungsbasierten Abrechnung kombiniert wird, wird die gemessene Nutzung aus dem vorherigen Abrechnungszyklus zusammen mit dem Festpreis für den neuen Abrechnungszyklus zu Beginn eines Intervalls berechnet. Die nutzungsbasierte Abrechnung und der Festpreis werden in einer Rechnung zusammengefasst.
Einschränkungen
Da die Verwendung mehrerer Produkte in einem Abonnement zu einer einzigen Rechnung und Zahlung führt, müssen alle Preise für diese Produkte die gleiche Währung und das gleiche Abrechnungsintervall haben. In einem Abonnement sind außerdem maximal 20 Produkte möglich.
Rabatte, Steuern und Testzeiträume
Bei der Verwendung mehrerer Produkte können Sie wie bei einem Abonnement für ein einzelnes Produkt auch Rabatte erstellen, Steuern einziehen und Testzeiträume verwenden. Geben Sie diese als übergeordnete Argumente für den Aufruf zum Erstellen oder Aktualisieren des Abonnements an, da sie für das Abonnement an sich gelten:
Wenn Sie ein Abonnement erstellen, indem Sie Preise an das Attribut items übergeben, wird jeder Testzeitraum ignoriert, der bei den einzelnen Preisen angegeben ist. Der Testzeitraum wird nur berücksichtigt, wenn Sie ein Abonnement mit einem einzigen Preis unter Verwendung des älteren Planattributs erstellen.
Mehrere Abonnements für eine/n Kund/in
Sie können mehrere Abonnements gleichzeitig für eine Kundin/einen Kunden erstellen. Diese Funktion ist hilfreich, wenn Ihre Kund/innen mehrere Produkte mit unterschiedlichen Intervallen abonnieren möchten. Jedes Abonnement hat seinen eigenen separaten Abrechnungszyklus, seine eigene Rechnung und seine eigene Abbuchung – unabhängig davon, ob die zugrunde liegenden Preise das gleiche Abrechnungsintervall aufweisen.
Erstellen Sie mehrere Abonnements für eine Kundin/einen Kunden, indem Sie den gleichen Code für Abonnement erstellen verwenden:
Eine Kundin/ein Kunde kann mehrere Produkte oder auch ein einzelnes Produkt mehrfach abonnieren. Jedes Abonnement verfügt über eine eindeutige ID und sein Status wird unabhängig von den anderen Abonnements der Kundin/des Kunden verarbeitet. Jedes Abonnement hat außerdem seinen eigenen unabhängigen Abrechnungszyklus, der auf dem Abrechnungszyklusanker des Abonnements basiert.
Wenn eine Kundin/ein Kunde mehrere Abonnements hat, gibt die Eigenschaft subscriptions des Customer-Objekts eine Auflistung der einzelnen Abonnements an:
{ "id": "cus_4fdAW5ftNQow1a", "object": "customer", "subscriptions": { "object": "list", "data": [ { "id": "sub_9RRl3XywPg2P5H", "object": "subscription", ... "price": { "id": "price_CZB2krKbBDOkTS", "object": "price", "amount": 2995, ... } }, { "id": "sub_9RRlIq2t9obFLI", "object": "subscription", ... "price": { "id": "price_CZB1AX3KOacNJw", "object": "price", "amount": 1295, ... } } ] ... } ... }