従量課金を設定する
注
従量課金プロセスを更新しました。以前のガイダンスの情報については、Stripe のレガシーの従量課金のドキュメントをご覧ください。
このガイドでは、従量課金モデルの中心となる概念を、Alpaca AI という架空の生成 AI 企業の視点から説明します。Alpaca AI はユーザーの 1,000 トークンの利用ごとに 0.04 USD の料金を、月末に後払いで請求します。
- Meter events (従量イベント): Meter events で示された顧客固有の情報を、Stripe に送信します。これらのイベントは、顧客がシステムで実行する未加工のアクションを、請求ベースの形成で表しています。この例では、顧客がクエリで使用したトークン数が含まれています。
- Meter (メーター): 従量イベントの構成可能なオブジェクトとしての Meter は、請求期間全体で従量イベントを集計する方法についてのガイドラインを提供します。この場合は、1 カ月間のトークンの合計になります。メーターは価格に関連付けられ、顧客の使用量を顧客のサブスクリプションにマッピングします。
- Meter event summary (従量イベントのサマリー): 顧客とメーターのイベントサマリーは、期間中の使用量の集計を返します (メーターが集計式を定義)。この例では、従量イベントのサマリーは、特定の顧客、メーター、および時間枠のトークンの合計を返します。従量イベントは読み取りパスで利用可能になることはなく、従量イベントのサマリー結果に非同期で集計されます。
- Prices (価格): Prices では、単価、通貨、請求サイクルを定義します。この例では、1,000 トークンあたり 0.04 USD のパッケージ料金を定義し、請求間隔を毎月としています。Prices (価格) の詳細をご確認ください。
- Subscription (サブスクリプション): Subscriptions では、ユーザーを特定の料金を関連付けることで、継続支払いを請求できるようにします。Subscriptions (サブスクリプション) の詳細をご確認ください。
この図は、以下の主要な概念を示しています。
構築する内容
このガイドでは以下の方法について説明します。
- 請求メーターと商品カタログを構築してビジネスをモデル化する
- サイトに支払いの回収セッションを追加する
- サブスクリプションイベントをモニタリングする
Stripe を設定する
任意の Stripe クライアントをインストールします。
次に、Stripe CLI をインストールします。CLI は Webhook のテストを提供しており、これを実行すると Stripe への API コールを実行できます。このガイドの後続セクションでは、CLI を使用して料金体系モデルを設定する方法を説明します。
その他のインストールオプションについては、Stripe CLI を使ってみるをご覧ください。
料金体系モデルを作成する
ダッシュボードまたは Stripe API を使用して、商品とその価格オプションを作成します。
顧客を作成する
各サブスクリプションには、顧客を作成する必要があります。アプリケーションのフロントエンドでユーザーから必要な情報を収集し、それをバックエンドに渡します。
サーバーで、Stripe の Customer オブジェクトを作成します。
支払い情報を収集する
サブスクリプションの作成で得られるレスポンスに記載されている client secret を使用して支払いの詳細を収集する方法についてご確認ください。
使用量を報告する
Meter Events (メーターイベント) を使用して、顧客のメーターに対する使用量の記録を開始できます。 ペイロードで顧客への参照と値を指定します。 Stripe は、報告された使用量を請求期間の最後に顧客に請求します。
使用量の記録で詳細をご確認ください。