# 高度な従量課金の仕組み Stripe で一般的な使用状況ベースの料金モデルを開始します。 アドバンスな従量課金では、SaaS および AI ビジネスが使用状況に基づいて顧客に課金しながら、継続手数料の請求やクレジットの管理も行えます。アドバンスな従量課金では、以下が可能になります。 - 特定の使用状況属性 (ディメンション) に基づいて請求を定義する - 1 メートルまたは数メートルにわたって数十から数百の料金を管理 - リアルタイムのクレジットバーンダウンを設定し、クレジット発行を自動化 - 価格移行の管理 サポートされる価格モデルは以下のとおりです。 - 従量課金 - 定額手数料と超過料金 - トップアップによるリアルタイムのクレジットバーンダウンモデル (初期金額を使用量に応じて段階的に消費) (See full diagram at https://docs.stripe.com/billing/subscriptions/usage-based/advanced/about) ## 高度な従量課金の概念 ここでは、高度な従量課金の仕組みを理解するための主な概念をご紹介します。 | 用語 | 定義 | | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 請求対象項目 | 料金プランのサブスクリプションに対応する請求書に表示される項目。従量課金またはライセンス課金が可能です。 | | [ライセンス料](https://docs.stripe.com/billing/subscriptions/usage-based/advanced/about.md#license-fee-concepts) | 月額サブスクリプション料金など、請求可能な項目に対する固定で定期的な料金。価格、請求頻度、課税の有無などの詳細が含まれます。[ライセンス料](https://docs.stripe.com/billing/subscriptions/usage-based/advanced/about.md#license-fee-concepts)の詳細はこちらをご覧ください。 | | ライセンス項目 | ライセンスが付与され、顧客に送信される請求書に表示される請求可能な項目です。 ライセンス料を作成 する際に、ライセンス項目の ID を渡します。 | | メーター | [メーター](https://docs.stripe.com/api/billing/meter.md)は、サービス期間における[メーターイベント](https://docs.stripe.com/api/billing/meter-event.md)の集計方法を指定します。メーターイベントは、顧客がシステム内で行うすべての操作 (API リクエストなど) を表します。従量アイテムがメーターに接続され、請求される項目を形成します。例えば、AI サービスを提供するビジネスでは、顧客のクエリで使用したトークン数を表すメーターイベントがある場合があります。メーターは 1 カ月間のトークンの合計を追跡し、その集計された使用量が請求期間ごとに生成される請求書の基礎となります。Stripe ダッシュボードまたは API を使用して[メーターを設定](https://docs.stripe.com/billing/subscriptions/usage-based/meters/configure.md)できます。 | | 従量アイテム | 従量アイテム。従量アイテムは、顧客が決済する特定の項目です。たとえば、LLM モデルやトークンの使用量の段階などです。従量アイテムは、複数のレートカードレートに適用できます。各従量アイテムは、メーターに関連付ける必要があります。 | | [料金プラン](https://docs.stripe.com/billing/subscriptions/usage-based/advanced/about.md#pricing-plan-concepts) | 価格設定コンポーネント(料金表、ライセンス料、定期的なクレジット付与など)のカスタマイズ可能なコンテナ。[料金プラン](https://docs.stripe.com/billing/subscriptions/usage-based/advanced/about.md#pricing-plan-concepts)の詳細はこちらをご覧ください。 | | [料金プランに基づくサブスクリプション](https://docs.stripe.com/billing/subscriptions/usage-based/advanced/about.md#pricing-plan-subscription-concepts) | 料金プラン・サブスクリプションは、顧客が特定の料金プラン・バージョンをサブスクライブしているときに作成されます。[料金プランサブスクリプション](https://docs.stripe.com/billing/subscriptions/usage-based/advanced/about.md#pricing-plan-subscription-concepts)の詳細はこちらをご覧ください。 | | レート | レートカードの従量制項目の料金体系設定。[レートカードとレート](https://docs.stripe.com/billing/subscriptions/usage-based/advanced/about.md#rate-card-concepts) の詳細をご覧ください。 | | [料金表](https://docs.stripe.com/billing/subscriptions/usage-based/advanced/about.md#rate-card-concepts) | 製品の使用状況に応じた料金を集めたもの。[料金表](https://docs.stripe.com/billing/subscriptions/usage-based/advanced/about.md#rate-card-concepts) について詳しくはこちらをご覧ください。 | | [サービスアクション](https://docs.stripe.com/billing/subscriptions/usage-based/advanced/about.md#service-action-concepts) | 定期的なクレジット付与と適用可能な請求項目を定義します。[サービスアクション](https://docs.stripe.com/billing/subscriptions/usage-based/advanced/about.md#service-action-concepts)の詳細はこちらをご覧ください。 | | サービス間隔 | サービス間隔は、価格モデルに照らしてサービスの使用状況を評価する期間と、顧客がいつサービスにアクセスできるようにするかの 2 点を定義します。ボリュームまたは段階的な価格設定 (例えば、最初の 100 ユニットを無料にする) を行った場合、制限はサービス間隔ごとにリセットされます。 | ### 料金プランの概念 料金プランを使うと、複数の料金構成要素をまとめて 1 つのプランとして課金できます。顧客は、利用量に応じた課金、定期料金、定期クレジットなどの 1 つ以上の構成要素を含む料金プランにサブスクライブします。既存の構成要素を変更するか、新しい要素を追加して料金プランの新しいバージョンを作成することができ、既存の顧客を最新バージョンに移行するかどうかも選択できます。 料金プランには、以下を任意に組み合わせることができます。 - レートカード - ライセンス手数料 - サービスアクション ここでは、すべてのコンポーネントを含む料金プランをご紹介します。 ![レートカード、ライセンス料金、サービスアクションを含む料金プランの例](https://b.stripecdn.com/docs-statics-srv/assets/pricing-plan.295b34e2ba8880b8c20edc782958f4a9.png) レートカード、ライセンス料金、サービスアクションを含む料金プラン。 ここでは、*Checkout* (A low-code payment integration that creates a customizable form for collecting payments. You can embed Checkout directly in your website, redirect customers to a Stripe-hosted payment page, or create a customized checkout page with Stripe Elements) での料金プラン全体の例をご紹介します。[Checkout を使用して顧客を料金プランに登録する方法](https://docs.stripe.com/billing/subscriptions/usage-based/pricing-plans.md?payment-ui=checkout)をご覧ください。 ![料金プラン例](https://b.stripecdn.com/docs-statics-srv/assets/checkout_pricing_plan_example.2156a15535345b113c30e7efabe72867.png) Stripe Checkout に表示される料金プラン | 用語 | 定義 | | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 料金プラン | 価格設定コンポーネント (レートカード、ライセンス料、継続クレジットなど) のカスタマイズ可能なコンテナで、サービスの請求方法を定義します。例えば、 | | 料金プランコンポーネント | 料金プランの一部です。レートカード、ライセンス手数料、または サービスアクションなどが含まれます。各コンポーネントには、料金プランで一貫して使用されるようにするためのバージョンがあります。コンポーネントを料金プランに関連付けない場合、デフォルトのバージョンが使用されます。 | | 料金プランサブスクリプション | 料金プランサブスクリプションは、顧客が特定の料金プランバージョンに登録したときに作成されます。サブスクリプションは、基になる請求サイクルに従って、顧客への請求を生成し、料金を請求します。 | | 料金プランのバージョン | 料金プランのバージョンは、料金プランのバージョン化されたスナップショットです。料金プランを作成する際は、本番バージョンを設定してから、プランを有効化するか、顧客をサブスクリプションに登録する必要があります。既存のコンポーネントを変更または削除すると、新しいバージョンが作成されます。コンポーネント (レートカード、ライセンス手数料、サービスアクション) を追加しても、新しいバージョンが作成されます。顧客をサブスクリプションに登録するときは、バージョンを指定するか、Stripe に現在の本番バージョンを割り当てることができます。顧客は手動で変更しない限り、割り当てられたバージョンのままになります。これにより、新規顧客と既存顧客で異なる料金を設定できます。 | #### 料金プランのバージョン管理 料金プランは、時間の経過に伴う請求構造の変更を管理するためのバージョニングをサポートします。料金プランの各バージョンは変更できません。既存のコンポーネントを変更または削除して料金プランを更新すると、Stripe が新しいバージョンを作成します。コンポーネント (レートカード、ライセンス手数料、サービスアクション) を追加した場合も、新しいバージョンが作成されます。このバージョニングシステムは、以下に役立ちます。 - 料金体系の変更のスケジュールを設定し、顧客に通知します。 - 顧客セグメントごとに異なる価格設定を管理します。 - 料金体系モデルの履歴を追跡および管理します。 各料金プランには 2 つのバージョンプロパティがあります。 - [latest_version](https://docs.stripe.com/api/v2/pricing-plans/pricing-plans/object.md?api-version=preview#v2_pricing_plan_object-latest_version): 更新後の最新バージョンです。 - [live_version](https://docs.stripe.com/api/v2/pricing-plans/pricing-plans/object.md?api-version=preview#v2_pricing_plan_object-live_version): 特定のバージョンが指定されていない限り、新しいサブスクリプションにデフォルトで使用されるバージョンです。 ### 料金プランサブスクリプションの概念 ここでは、料金プランのサブスクリプションの仕組みを理解するための主な概念について説明します。 | 用語 | 定義 | | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 請求期間 (頻度) | 請求間隔は、請求書を送信・生成するタイミングを定義します。生成された請求書には、1 つ以上のサービス期間中に発生した料金のみがまとめられます。ビジネスモデルに合わせて、異なる請求間隔を設定することが可能です。以下に例を示します。 - **月次**: 顧客は、前月のすべてのサービス使用状況に関する月次の請求書を受け取ります。 - **四半期ごと**:使用状況手数料は毎月発生しますが、請求書は 3 か月に 1 回しか生成されません。 - **年間**: その年に使用されたすべてのサービスの請求書を顧客に年に 1 回発行します。 請求期間は顧客に帰属します。1 つの請求期間は 1 人の顧客に対応します(各顧客は複数の請求期間を持つことができます)。 | | 料金プランサブスクリプション | 料金プランサブスクリプションは、顧客が特定の料金プランバージョンに登録すると作成されます。サブスクリプションは、基になる請求[サイクル](https://docs.stripe.com/api/v2/billing-cadences.md?api-version=preview)に従って顧客への請求を生成し、料金を請求します。 | ### 料金表のコンセプト ここでは、料金表の仕組みを理解するための主要な概念を説明します。 | 用語 | 定義 | | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ディメンション | ディメンションを使用すると、1 つ以上のプロパティに基づいて変動する従量請求の料金体系モデルを作成できます。メーターまたは従量項目の作成時、または使用量の送信時にディメンションを指定できます。 | | レートカード | レートカードは、プロダクトの使用状況に応じたレートを集めたものです。請求間隔に関連付けられた料金プランサブスクリプションを作成することで、顧客にレートカードをサブスクライブできます。 | | レートカード料金 | レートカードレート は、レートカードの従量アイテムの料金設定です。レートは、価格タイプ (固定レート、ボリューム、段階制、超過)、価格金額、数量設定 (個別ユニットまたはユニットのパッケージを販売可能) を定義します。各レートカードには、複数のレート (最大 500) を含めることができます。 | | 料金表のバージョン | レートカードバージョンは、レートカードのバージョン付きスナップショットです。レートカードを作成すると、初期のライブバージョンが新規サブスクライバーのデフォルトとして設定されます。既存レートの変更または削除は新しいバージョンを作成しますが、新しいレートの追加では新しいバージョンは作成されません。顧客をサブスクライブする際は、バージョンを指定するか、Stripe に現在のライブバージョンを割り当てさせることができます。顧客は手動で変更しない限り割り当てられたバージョンのままとなり、新規顧客と既存顧客で異なる料金体系を設定できます。 | ### ライセンス料の概念 | 用語 | 定義 | | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ライセンス料金 | ライセンス手数料は、月次のサブスクリプション手数料などの請求対象項目に対する固定の継続支払いです。価格、請求頻度、税金処理などの詳細情報が含まれます。 | | ライセンス料金バージョン | ライセンス料のスナップショットです。ライセンス料を作成すると、初期のライブバージョンが新しい加入者向けのデフォルトとして設定されます。ライセンス料を価格プランに追加する際には、特定のバージョンを指定するか、Stripe に現在のライブバージョンを割り当てさせることができます。ライセンス料を価格プランに追加・更新すると、価格プランのバージョンが更新されます。その後、価格プランに追加の変更を加えたり、新しい価格プランのライブバージョンを設定することも可能です。 | ### サービスアクションの概念 | 用語 | 定義 | | --------- | ---------------------------------------------------------------------------------------------------- | | サービスアクション | サービスアクションは、継続的なクレジット付与を定義し、金額、請求の頻度、該当する請求対象アイテムを指定します。このクレジットは、使用量に基づいた手数料など、特定のアイテムの請求を減らすことができます。 | | タイプ | 作成する特定の継続アクション。(現在、`credit_grant` のみがサポートされています。) | ## ライフサイクル 料金プランのライフサイクルは以下のようになります。 1. 料金プランを作成します。料金プランには、レートカード、ライセンス料金、サービスアクションを含めることができます。 2. Checkout または API を使用して顧客を料金プランに登録します。 3. 使用量はサービス期間ごとに記録および集計されます。 4. 請求期間に従ってサブスクリプションの請求書が作成されます。 5. 顧客の決済手段に請求が行われます。 ## 請求期間とサービス期間 請求期間 は、請求書を作成するタイミングを定義します。作成される請求書は、1 つ以上のサービス期間で発生した料金を統合します。ビジネスモデルと料金体系に合わせて、さまざまな請求期間を設定できます。サービス期間は請求期間以上の長さに設定する必要があります。たとえば、四半期のサービス期間を四半期または月次の請求サイクルで設定できますが、月次のサービス期間を四半期の請求サイクルで設定することはできません。 サービス期間が終了すると、Stripe が当該期間中のご利用実績と継続的な基本料金に基づきご請求額を計算します (例: 過去 1 週間の顧客の利用状況)。これら料金は顧客のアカウントに追加され、新しい請求書項目として作成されますが、必ずしも即座に決済されるわけではありません。 請求期間が終了すると、最後の請求期間以降に発生したすべての料金が請求書にまとめられ、顧客に送信されます。 この分離により、年次の請求による月次のサービス測定や、週次の請求による日次のサービス測定など、柔軟な請求が可能になります。 ### 例 顧客は完了したサービス期間に対してのみ請求されます。サービス期間の使用量がまだ発生中に顧客に請求される場合、料金プランのサブスクリプションには、前のサービス期間の使用量のみが含まれます。新しい使用量は、次の請求期間の請求書に追加されます。 ライセンス料は請求サイクルに関係なく、常に 1 サービス期間分が前払請求されます。 #### サービス期間は 5 カ月、請求期間は年間 この例では、ビジネスに以下の設定があります。 - **サービス期間**: 5 カ月ごと - **請求期間**: 毎年 3 月 31 日 顧客は、年間請求期間内に完了したサービス期間に対してのみ請求されます。この例では、請求書は 2 つの完了したサービス期間を表す 10 カ月の使用量に対するものです。 ![5 カ月のサービス期間が年間請求期間に請求される仕組みを示す図。](https://b.stripecdn.com/docs-statics-srv/assets/service-interval-5-month-cadence-annual-diagram.0ce339d4cc38cd8956e0dda7ad39d9d7.png) 5 カ月のサービス期間と年間請求期間では、顧客に請求されるのは完了したサービス期間のみです。 ### 請求期間とサービス期間を別々に設定する 使用量を週単位で評価することで、顧客により頻繁な使用期間を提供できます (これがサービス期間です)。しかし、管理上の負担を減らすために、請求書の生成は月単位のみにすることもできます (これが請求期間です)。 サービス期間と請求期間を別々に定義することで、ある頻度 (毎週など) では使用量を集計してアクセスをプロビジョニングし、別の頻度 (毎月など) では顧客に請求書を発行するという柔軟性が得られます。これは、キャッシュフローの最適化に役立ちます。 #### ダッシュボード ダッシュボードで請求期間とサービス期間を別々に設定するには、以下のようにします。 1. レートカードを作成します。 2. 使用量を集計する頻度を決定するサービス期間を定義します (毎週など)。 3. 顧客をレートカードに登録する。 4. 請求書を発行する頻度を決定する請求期間を定義してください (例: 毎月－これはサービス期間と同じ頻度でなくても構いません)。 #### API API を使用して請求期間とサービス期間を別々に設定するには、以下の手順を実行します。 最初に、レートカードを作成します。このとき、`service_interval` を定義するとともに、表示名と課税する動作を設定します。この例では、サービス期間は週単位です。 ```curl curl -X POST https://api.stripe.com/v2/billing/rate_cards \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-05-27.preview" \ --json '{ "display_name": "Hypernian", "service_interval": "week", "service_interval_count": 1, "currency": "usd", "tax_behavior": "exclusive" }' ``` また、従量アイテムの作成とレート も必要です。 顧客の月次の請求期間を定義します。`billing_cycle` パラメーターは、支払人に請求するタイミングと方法を定義します。 ```curl curl -X POST https://api.stripe.com/v2/billing/cadences \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-05-27.preview" \ --json '{ "payer": { "type": "customer", "customer": "{{CUSTOMER_ID}}" }, "billing_cycle": { "type": "month", "interval_count": 1, "month": { "day_of_month": 20 } } }' ``` 最後に、 料金プランのサブスクリプションを作成して、料金プランを請求期間に紐付けます。 ```curl curl -X POST https://api.stripe.com/v2/billing/intents \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-05-27.preview" \ --json '{ "cadence": "{{BILLING_CADENCE_ID}}", "currency": "usd", "effective_at": "on_commit", "actions": [ { "type": "subscribe", "subscribe": { "type": "pricing_plan_subscription_details", "proration_behavior": "none", "pricing_plan_subscription_details": { "pricing_plan": "{{PRICING_PLAN_ID}}", "pricing_plan_version": "{{PRICING_PLAN_VERSION_ID}}", "component_configurations": [] } } } ] }' ``` ## Revenue Recognition [従量課金](https://docs.stripe.com/billing/subscriptions/usage-based-v2/overview.md) の [収益認識](https://docs.stripe.com/revenue-recognition.md)は、AI または SaaS ビジネスで柔軟な消費ベースの価格モデルを活用できるようにしながら、正確な財務報告を保証します。これは、販売時や請求書発行時ではなく、サービスが実際に提供または消費されたときに収入が認識されるデリバリーベースのアプローチに従っています。 収益認識には 2 つの重要な要素があります。 - **販売取引**: 従量課金ベースのサービスの販売と、サービスが実際に消費された日時を記録。 - **請求書の項目**: 顧客がいつ請求書を発行したかを記録します。 ### 従量課金の収益認識の仕組み 従量課金では、収益認識には主に 3 つの段階があります。 - **収益計上**: 収益は、サービスの実際の消費に基づいて、引渡時に認識されます。 - **収益差戻し**: 請求書が確定した時点で、当初の収益計上を差戻します。このステップは、収益認識が顧客への請求を正確に反映するために不可欠です。 - **請求書の再予約**: 請求書が確定した場合、請求額に対して実際の処理を認識することを指します。 #### 例 この例では、顧客が 3 カ月間に 100 USD 分の API コールを消費し、その後請求されるとします。 - 1 月 (収益計上): 最初の月に、40 USD 分の API コールを消費します。 - 2 月 (収益計上): 2 カ月目に 35 USD 分の API コールを消費。 - 3 月 (収益計上): 3 カ月目に 25 USD 分の API コールを消費。 - 4 月 (請求書の収益差戻しと再予約): 3 カ月後、顧客は 100 USD の請求書を受け取ります (使用状況の合計)。 - 5 月 (決済): 顧客は 100 USD の請求書を支払います。 | アカウント | 2025 年 1 月 | 2025 年 2 月 | 2025 年 3 月 | 2025 年 4 月 | 2025 年 5 月 | 合計 | | ------ | ---------- | ---------- | ---------- | ---------- | ---------- | -------- | | 売上 | +40 USD | +35 USD | +25 USD | | | +100 USD | | 未請求 AR | +40 USD | +35 USD | +25 USD | -100 USD | | | | AR | | | | +100 USD | -100 USD | | | 現金 | | | | | +100 USD | +100 USD | ### 制限事項 従量課金の収益認識には、プライベートプレビュー中に以下の制限があります。 - 現在、`last` または `max` の集計タイプを使用するメーターはサポートされていません。 - 高度な従量課金では、[billable_items](https://docs.stripe.com/api/billing/credit-grant/object.md?api-version=preview#billing_credit_grant_object-applicability_config-scope-billable_items) を使用しますが、これは現在のレポートでは完全には対応していません。 - 従量課金の取引の仕訳エントリに、`billable_item` ID が製品 ID として表示されます。ただし、レポートでは、商品名、説明、その他の属性などの商品詳細は空白で表示されます。 ## 税金の自動計算 [料金プランサブスクリプション](https://docs.stripe.com/billing/subscriptions/usage-based/pricing-plans/subscriptions.md)料金プランSubscriptions に対して自動課税するには、[Stripe Checkout](https://docs.stripe.com/payments/checkout.md) を使用するか、API を直接使用します。 #### Checkout ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -H "Stripe-Version: 2025-09-30.preview;checkout_product_catalog_preview=v1" \ -d customer={{CUSTOMER_ID}} \ -d "checkout_items[0][type]=pricing_plan_subscription_item" \ -d "checkout_items[0][pricing_plan_subscription_item][pricing_plan]={{PRICING_PLAN_ID}}" \ -d "checkout_items[0][pricing_plan_subscription_item][component_configurations][{{LICENSE_COMPONENT_ID}}][type]=license_fee_component" \ -d "checkout_items[0][pricing_plan_subscription_item][component_configurations][{{LICENSE_COMPONENT_ID}}][license_fee_component][quantity]=1" \ -d "automatic_tax[enabled]=true" ``` #### API 顧客を料金プランに登録するには、以下を行う必要があります。 1. [顧客を作成します](https://docs.stripe.com/api/customers/create.md)。これには、[Checkout セッションで](https://docs.stripe.com/billing/subscriptions/usage-based/advanced/about.md#set-up-checkout)作成された顧客を指定できます。 2. 料金プランのサブスクリプションのために、[請求プロファイル](https://docs.stripe.com/api/v2/billing-profile.md?api-version=preview) を作成してください。 3. 課税を有効にして請求設定を作成 します。 4. 請求サイクルを作成 します。 5. [請求インテント](https://docs.stripe.com/api/v2/billing-intents/intents/create.md?api-version=preview)を作成します。これにより、料金プランと請求周期を参照する[料金プランサブスクリプション](https://docs.stripe.com/api/v2/pricing-plan-subscriptions.md)が作成されます。 顧客を作成します。 ```curl curl https://api.stripe.com/v1/customers \ -u "<>:" \ --data-urlencode "email=jenny.rosen@example.com" \ -d "name=Jenny Rosen" ``` 請求プロファイルの作成 ```curl curl -X POST https://api.stripe.com/v2/billing/profiles \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-05-27.preview" \ --json '{ "customer": "{{CUSTOMER_ID}}", "display_name": "Automatic collection settings", "lookup_key": "billing_profile_cus_123", "metadata": { "test": "data" } }' ``` 請求の頻度で税金の動作を制御するには、 請求設定オブジェクトを作成 します。 ```curl curl -X POST https://api.stripe.com/v2/billing/bill_settings \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-05-27.preview" \ --json '{ "display_name": "Re-selling configuration", "calculation": { "tax": { "type": "automatic" } } }' ``` 次に、請求プロファイル を請求頻度に追加します。 ```curl curl -X POST https://api.stripe.com/v2/billing/cadences \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-05-27.preview" \ --json '{ "payer": { "billing_profile": "{{BILLING_PROFILE_ID}}" }, "billing_cycle": { "type": "month", "interval_count": 1, "month": { "day_of_month": 20 } } }' ``` [請求インテント](https://docs.stripe.com/api/v2/billing-intents/intents/object.md)を作成し、料金プラン ID と請求周期 ID を渡して、顧客を料金プランに登録します。 ```curl curl -X POST https://api.stripe.com/v2/billing/intents \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-05-27.preview" \ --json '{ "currency": "usd", "cadence": "{{CADENCE_ID}}", "actions": [ { "type": "subscribe", "subscribe": { "type": "pricing_plan_subscription_details", "pricing_plan_subscription_details": { "pricing_plan": "{{PRICING_PLAN_ID}}", "pricing_plan_version": "{{PRICING_PLAN_VERSION}}", "component_configurations": [] } } } ] }' ``` 次に、その請求インテントを予約してください。請求インテントを[予約](https://docs.stripe.com/api/v2/billing-intents/intents/reserve.md?api-version=preview)する際に生成されるプレビューに基づいて、顧客にいくら請求するかを決定できます。 ```curl curl -X POST https://api.stripe.com/v2/billing/intents/{{BILLING_INTENT_ID}}/reserve \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-05-27.preview" ``` 次に、請求インテントをコミットして料金プランのサブスクリプションを有効にし、プランと頻度に従って顧客に請求書します。徴収設定で自動支払いが設定されている場合は、[PaymentIntent](https://docs.stripe.com/api/payment_intents.md) ID も指定する必要があります(徴収設定を `send_invoice` に設定している場合は、これを行う必要はありません)。PaymentIntent ID を取得するには、応答で確認するか、[すべての PaymentIntents](https://docs.stripe.com/api/payment_intents/list.md) をリストするか、ダッシュボードの[決済ページ](https://dashboard.stripe.com/payments)で確認します。 ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=1000 \ -d currency=usd \ -d customer={{CUSTOMER_ID}} \ -d payment_method={{PAYMENT_METHOD_ID}} \ --data-urlencode "return_url=https://example.com/return" \ -d confirm=true ``` ```curl curl -X POST https://api.stripe.com/v2/billing/intents/{{BILLING_INTENT_ID}}/commit \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-05-27.preview" \ --json '{ "payment_intent": "{{PAYMENT_INTENT_ID}}" }' ``` 顧客のサブスクリプション時に、オプションで料金プランの特定のバージョンを渡すことができます。バージョンを指定しない場合、サブスクリプションでは料金プランの本番バージョンが適用されます。 ```curl curl -X POST https://api.stripe.com/v2/billing/intents \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: 2026-05-27.preview" \ --json '{ "currency": "usd", "effective_at": "on_commit", "cadence": "bc_test_61SrjnScUwT6mNskZ16SjPfE4ZSQFjWjdqlzQfWMCVnM", "actions": [ { "type": "subscribe", "subscribe": { "type": "pricing_plan_subscription_details", "proration_behavior": "none", "pricing_plan_subscription_details": { "pricing_plan": "{{PRICING_PLAN_ID}}", "pricing_plan_version": "{{PRICING_PLAN_VERSION}}", "component_configurations": [] } } } ] }' ```