複数の商品のサブスクリプション
複数の商品のサブスクリプションを作成し、すべてを 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": [ ] },
複数の価格を使用する請求期間
定期的に固定金額を請求する標準的な料金は、各請求サイクルの開始時に請求されます。請求書ごとに、顧客は実質的に次の期間のサービスに対して支払いを行います。従量課金では、請求サイクル中の顧客の使用量によって支払い金額が異なるため、顧客はその期間の最後に使用量に対して支払いを行います。
1 つのサブスクリプションで固定料金と従量課金を組み合わせると、各期間の開始時に、新しい請求サイクルの固定料金とともに、前の請求サイクルの使用量に対する請求が行われます。このようなケースでは、従量課金と固定料金が 1 つの請求書にまとめられます。
制限
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, ... } } ] ... } ... }