商品と価格を使用した従量課金の設定

商品やサービスの使用量に基づいて顧客に請求します。

従量課金では、商品やサービスの使用量に応じて顧客に請求できます。

このガイドでは、Procuct (製品) と Price (価格) を使用して、メーターを作成する方法、料金体系と請求書を設定する方法、メーターイベントを送信して顧客の使用量を記録する方法について解説します。Alpaca AI という架空の生成 AI 企業をモデルに、従量課金モデルのコア概念について学びます。Alpaca AI は、100 トークンあたり 0.04 USD を顧客に販売し、月末に後払いで請求していると仮定します。

Here’s what the lifecycle looks like for a typical usage-based billing integration that uses products and prices:

メーターを作成する

Meters specify how to aggregate meter events over a billing period. Meter events represent all actions that customers take in your system (for example, API requests). Meters attach to prices and form the basis of what’s billed.

For the Alpaca AI example, meter events are the number of tokens a customer uses in a query. The meter is the sum of tokens over a month.

You can use the Stripe Dashboard or API to configure a meter. To use the API with the Stripe CLI to create a meter, get started with the Stripe CLI.

On the Meters page, click Create meter.
On the Create meter page, do the following:
- For Meter name, enter the name of the meter to display and for organization purposes. For the Alpaca AI example, enter “Alpaca AI tokens.”
- For Event name, enter the name to display in meter events when reporting usage to Stripe. For the Alpaca AI example, enter “alpaca_ai_tokens.”
- Select Sum from the Aggregation method dropdown to set the aggregation formula.
- Click Create meter.

料金体系モデルを作成する

Stripe ダッシュボードまたは API を使用して、Product (商品) とその価格オプションを含む料金モデルを作成します。Price (価格) は、単価、通貨、請求サイクルを定義します。

Alpaca AI の例では、1,000 ユニットあたり 0.04 USD の従量制料金で、月ごとに請求を行う商品を作成します。前のステップで作成した従量を使用します。

商品カタログページで、商品を作成をクリックします。
商品を追加 ページで、以下を実行します。
- 名前には、商品の名前を入力します。Alpaca AI の例では、Alpaca AI と入力します。
- (オプション) 説明には、商品の購入時にカスタマーポータルと見積もりに表示する説明を追加します。
- 継続を選択します。
- 請求期間で、その他の料金体系オプションを選択します。
料金を追加ページで、次の操作を行います。
- 料金体系モデルを選択 で、従量課金 と パッケージあたり を選択します。
- 価格で、金額を 1000 ユニットあたり 0.04 USD に設定します。
- 従量で、ドロップダウンから AlPACA AI トークン を選択します。
- 請求期 で、Monthly を選択します。
- 次へをクリックします。
商品を追加 ページで、商品を追加 をクリックします。

顧客を作成する

次に、customerを作成します。

顧客ページで、顧客を追加 をクリックします。
顧客を作成 ページで、以下を実行します。
- 名前には、顧客の名前を入力します。AlPACa AI の例では、John Doe と入力します。
- (オプション) 顧客のメールアドレスと説明を追加します。
- 顧客を追加 をクリックします。

サブスクリプションを作成

サブスクリプションを使用すると、顧客を特定の価格に関連付けて、継続的な金額を請求することができます。

Stripe ダッシュボードまたは API を使用して、顧客、商品、従量課金ベースの価格を含むサブスクリプションを作成します。

Alpaca AI の例では、Alpaca AI 商品のサブスクリプションを、ユニットあたり 0.04 USD の従量制料金で、月ごとに John Doe に請求を行う商品を作成します。

注

1 つの従量制料金を複数のサブスクリプションに関連付けることができます。

サブスクリプションページで、テスト用サブスクリプションを作成 をクリックします。
テスト用サブスクリプションを作成 ページで、以下を実行します。
- 顧客で、顧客の名前を選択します。AlPACa AI の例では、John Doe と入力します。
- 製品で、価格を選択します。Alpaca AI の例では、Alpaca AI で価格を選択します。
- (オプション) 必要に応じて、サブスクリプションの詳細と設定を変更します。
- テスト用サブスクリプションを作成 をクリックします。

テストの従量イベントを送信

メーターイベントを使用して、メーターの顧客の使用量を記録します。請求期間の終了時に、Stripe は報告された使用量を請求します。

Stripe ダッシュボードまたは API を使用して、従量課金のイベントを送信し、従量課金をテストできます。API を使用する場合は、顧客 ID と payload の値を指定します。

従量イベントを送信した後、ダッシュボードの従量ページで従量に関する使用量の詳細を確認できます。

従量ページで、従量課金の名前を選択します。AlPACa AI の例では、AlPACA AI トークン を選択します。
従量ページで、使用量を追加 > 使用量を手動で入力 をクリックします。
使用料を追加 ページで、以下を実行します。
- 顧客ドロップダウンから、対象の顧客を選択します。
- 値には、サンプルの値を入力します。AlPACa AI の例では、3000 と入力します。
- 送信をクリックします。

請求書プレビューを作成する

請求書プレビューを作成することで、メーターの価格や使用量などの詳細が記載された顧客の請求書をプレビュー表示できます。

サブスクリプションページで、任意のサブスクリプションを選択します。 For the Alpaca AI の例では、John Doe のサブスクリプションを選択します。
サブスクリプションの詳細ページで、次回の請求書 セクションまで下にスクロールします。プレビューの請求書には、指定した日付に顧客に請求するサブスクリプションの金額が表示されます。
すべての請求書を表示 をクリックすると、次のような請求書の詳細を確認できます。
- 顧客
- 請求方法
- 作成日
- 関連付けられたサブスクリプション
- サブスクリプションの詳細 (使用量と従量課金)
- 請求金額
Stripe は従量イベントを非同期に処理するため、以降の請求書には、最近受信した従量イベントが即時に反映されない可能性があります。

注