コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン
概要
Billing
概要Billing API について
税金
概要
レポート機能
概要複数のアカウントのレポート
データ
概要

メモ

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

従量課金の料金体系モデルを設定する

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

Pay-as-you-go pricing is a flexible, scalable model that lets you charge customers in arrears for the usage they accrue. AI businesses, SaaS platforms, and cloud services often use this pricing model.

作成する内容

本ガイドでは、Hypernian という架空の会社に対して、Stripe で従量課金制の価格設定を実装する方法について説明します。Hypernian は、LLM モデルに対して次の料金を顧客に請求します。

使用状況手数料
トークン100 トークンあたり 0.04 USD

この料金体系モデルを実装するには、メーターを作成し、料金体系と請求を設定し、メーターイベントを送信して、Products と Prices を使用して顧客使用状況を記録します。

メーターを作成する

メーターは、請求期間中のメーターイベントを集計する方法を指定するものです。メーターイベントは、顧客がシステムで実行するすべてのアクション (API リクエストなど) を表します。メーターは料金に関連付けられており、請求内容の基礎になります。

Hypernian の例では、メーターイベントは、顧客がクエリで使用するトークンの数です。メーターは、1 か月間のトークンの合計です。

Stripe ダッシュボードまたは API を使用してメーターを設定できます。Stripe CLI で API を使用してメーターを作成するには、Stripe CLI を始める を参照してください。

  1. メーター ページで、メーターを作成 をクリックします。
  2. メーターエディターで以下を実行します。
    • メーター名 に、表示するメーターの名前と整理目的で入力します。Hypernian の例には、「Hypernian トークン」と入力します。
    • イベント名 に、Stripe に使用状況を報告するときにメーターイベントに表示する名前を入力します。Hypernian の例には、「hypernian_tokens」と入力します。
    • ドロップダウンで 集計方法 を設定します。
      • Hypernian の例では、 合計 を選択します。これにより、報告れた 値が合計 され (この例では、顧客が使用するトークンの数)、請求する使用量が決定されます。
      • 報告されたイベントの_数_に基づいて カウント を選択し、請求します。
      • 最終 を選択して、報告された_最終値_に基づいて請求します。
      • プレビューペインを使用して、使用状況例イベントを設定し、集計方法を確認します。
    • メーターを作成 をクリックします。
    • (オプション) 詳細設定 で、使用状況データにタグ付けする ディメンション を指定します。セグメント固有のアラートをきめ細かく生成したり、属性の組み合わせに基づいて使用状況を細かく価格設定したりするには、分析とレポート作成用に入力されたディメンションを使用して使用状況データを送信します。ディメンションの例としては、LLM モデル、トークンタイプ、地域、イベントタイプなどがあります。

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

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

Hypernian の例では、100 ユニットあたり 0.04 USDの従量制価格で、月単位で請求される製品を作成します。前のステップで作成したメーターを使用します。

  1. 商品カタログ ページで、商品を作成 をクリックします。
  2. 商品を追加 ページで、以下を実行します。
    • 名前 に、製品の名前を入力します。Hypernian の例には、Hypernian と入力します。
    • (オプション) 説明 には、Checkout、カスタマーポータル、見積もり に表示する説明を追加します。
    • 継続 を選択します。
    • 請求期間 で、その他の料金体系オプション を選択します。
  3. 価格を追加 ページで、以下を実行します。
    • 料金体系モデルを選択 で、従量制 を選択します。
    • 料金体系を選択:
      • Hypernian の例では、 パッケージごと を選択します。価格 で、 金額 を 0.04 USD につき 100 単位。
      • ユニット単位 を選択して、ユーザー数、ユニット数、シート数で価格を設定します。
      • 段階制 を選択して 段階制料金 を有効にし、数量または使用状況に応じて単価を変更します。
    • メーター で、手順 1 で作成したメーターを選択します。Hypernian の例では、ドロップダウンから Hypernian トークン を選択します。
    • 適切な 請求期間 を選択します。Hypernian の例では、 月次 を選択します。
    • 次へ をクリックします。
  4. 商品を追加 ページで、商品を追加 をクリックします。

顧客を作成する

次に、 顧客 を作成します。

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

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

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

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

Hypernian の例では、Hypernian 製品のサブスクリプションを作成し、100 ユニットあたり 0.04 USDの従量制料金で、John Doe に毎月請求されます。

メモ

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

billing_mode=flexible サブスクリプションを作成すると、従量制の項目は最初の請求書から除外されます。これは、請求書に以前の使用状況がないためです。Stripe は、サブスクリプションが以前に発生した使用状況で遡及されている場合、または保留中の請求書項目が存在する場合にのみ請求書を作成します。billing_mode=classic サブスクリプションを作成すると、Stripe は従量制サブスクリプション項目ごとにゼロの金額の請求書の項目を生成します。

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

テストのメーターイベントを送信

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

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

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

  1. メーター ページで、メーター名を選択します。Hypernian の例では、 Hypernian トークン を選択します。
  2. メーターページで、使用量を追加 > 使用量を手動で入力 をクリックします。
  3. 使用量を追加 ページで、以下を実行します。
    • Customer ドロップダウンから、対象の顧客を選択します。
    • 値 に、サンプル値を入力します。Hypernian の例には、3000 と入力します。
    • 送信 をクリックします。

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

プレビュー請求書を作成 して、メーター価格や使用量などの詳細を含む顧客の請求書のプレビューを表示します。

  1. サブスクリプションページで、サブスクリプションを選択します。Hypernian の例では、 John Doe のサブスクリプションを選択します。

  2. サブスクリプションの詳細ページで、次回の請求書 セクションまで下にスクロールします。プレビューの請求書には、指定した日付に顧客に請求するサブスクリプションの金額が表示されます。

  3. すべての請求書を表示 をクリックすると、次のような請求書の詳細を確認できます。

    • 顧客
    • 請求方法
    • 作成日
    • 関連付けられたサブスクリプション
    • サブスクリプションの詳細 (使用量とメーター価格)
    • 請求金額

    Stripe はメーターイベントを非同期に処理するため、以降の請求書には、最近受信したメーターイベントが即時に反映されない可能性があります。

オプションカスタム期間の使用量を取得

メーターイベントサマリー を使用して、カスタム期間の合計使用状況を取得します。メーターイベントのサマリーは、メーターによって定義される集計式を基に、期間中の顧客の使用状況を集計して返します。

Hypernian の例では、メーターイベントの概要は、特定の顧客、メーター、および時間枠のトークンの合計を返します。

Stripe はメーターイベントを非同期に処理するため、メーターイベントサマリーには、最近受信したメーターイベントが即時に反映されない可能性があります。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -G https://api.stripe.com/v1/billing/meters/{{METER_ID}}/event_summaries \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer={{CUSTOMER_ID}} \
  -d start_time=1717249380 \
  -d end_time=1717249440

次のステップ