複数の商品のサブスクリプション
複数の商品のサブスクリプションを作成し、すべてを 1 つの請求書で請求します。
複数の商品を提供している場合、または同じ商品で異なる金額を請求する場合は、サブスクリプションに複数の商品を関連付けることができます。これにより、請求期間ごとにすべての価格をまとめた 1 件の請求書が生成されます。その請求書に対する支払いは 1 回で済むため、コストを削減し、顧客への請求回数を減らすことができます。
複数の商品のサブスクリプションを作成する
items パラメータを使用して、顧客に複数の商品のサブスクリプションを作成します。各商品に対し、price、および任意で quantity (1 以外の値を使用する場合) を指定します。
応答には、すべてのサブスクリプションアイテム、価格、数量のリストが含まれます。
{ "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": [ ] },
複数の価格を使用する請求期間
Conventional prices that charge a fixed amount on an interval are billed at the start of each billing cycle. With each invoice, the customer effectively pays for the next interval of service. With usage-based billing, the amount paid by the customer varies based on consumption during the billing cycle, so the customer pays for their usage at the end.
When a subscription combines a fixed rate with usage-based billing, metered usage from the previous billing cycle is charged alongside the fixed rate for the new billing cycle at the start of each interval. The usage-based billing and fixed rate are combined in a single invoice.
制限
1 件のサブスクリプションに複数の商品を含めた場合、請求書は 1 枚で、支払いも 1 回となるため、商品の価格には同じ通貨を使用し、請求期間も同じにする必要があります。また、1 件のサブスクリプションに含められる商品数は、最大 20 点です。
割引、税金、トライアル期間
複数の商品を使用する際、単一商品のサブスクリプションの場合と同様に、割引の作成、課税、トライアル期間の設定も可能です。これらを最上位の引数として、サブスクリプション作成コールまたは更新コールに指定してください。サブスクリプション全般に適用されます。
items 属性に価格を渡してサブスクリプションを作成すると、個々の価格に指定されたトライアル期間は無視されます。トライアル期間が考慮されるのは、レガシーのプラン属性を使用して、単一の価格でサブスクリプションを作成した場合のみです。
同一の顧客向けに対する複数のサブスクリプション
同一の顧客に対して、複数のサブスクリプションを同時に作成できます。この機能は、顧客が期間の異なる複数の商品に登録できるようにする場合に便利です。基礎となる価格の請求期間が同じであっても、各サブスクリプションには独自の請求サイクル、請求書および請求が存在します。
同じサブスクリプションの作成コードを使用して、特定の顧客に対して複数のサブスクリプションを作成します。
顧客は、複数の商品に登録したり、同一の商品に何度も登録したりすることもできます。各サブスクリプションに一意の ID が設定され、その状態は顧客の他のサブスクリプションとは別に処理されます。また、各サブスクリプションは、サブスクリプションの請求サイクルの起点に基づく独自の請求サイクルを持ちます。
顧客に複数のサブスクリプションが存在する場合は、Customer オブジェクトの subscriptions プロパティを指定することで、サブスクリプションのリストが提供されます。
{ "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, ... } } ] ... } ... }