Credit-Based Billing

​

クレジットベースの請求とは？

• AIおよびLLMプラットフォーム：プラン階層ごとにトークンまたは生成クレジットを付与
• APIサービス：APIコールクレジットを過剰料金と共に割り当て
• インフラストラクチャプラットフォーム：コンピュート時間またはストレージクレジットを発行
• 通信サービス：サブスクリプションごとにメッセージまたは分のクレジットを提供
• 使用量ベースのSaaS：クレジットプールに含まれる使用量をバンドル

​

コアコンセプト

​

クレジットタイプ

​

クレジットライフサイクル

​

クレジット源

​

クレジットの作成

1

Navigate to Credits

ダッシュボードの Products に移動し、Credits タブを選択します。Create Credit をクリックして開始します。

2

Configure Basic Information

クレジット名を入力します - これはクレジットの内部識別子です。

3

Set General Settings

クレジットタイプと表示プロパティを構成します：

​

Credit Type

string

必須

Custom Unit または Fiat Credits を選択します。

• Custom Unit - 独自のメトリック（トークン、APIコール、コンピュート時間）を定義します。 Unit Name（例：「プラットフォームトークン」）と精度の設定が必要です。
• Fiat Credits - クレジットは実際の通貨価値を表します。 Unit Currency（USD、EUR、GBP、INRなど）の選択が必要です。

​

Unit Name

string

カスタムユニットクレジットのみ。このクレジットのラベル（例：「AIトークン」、「APIコール」）。チェックアウトと顧客ポータルに表示されます。

​

Precision

number

カスタムユニットクレジットのみ。許可される小数点桁数：

• 0 - 整数（APIコールのようなカウント可能なアイテムに最適）
• 1 - 1つの小数点（0.0）
• 2 - 2つの小数点（0.00） - デフォルト
• 3 - 3つの小数点（0.000）

クレジット作成後、精度は変更できません。

​

Credit Expiry

string

発行後のクレジットの有効期間：

• 7日, 30日（デフォルト）, 60日, 90日, カスタム, または 無期限

カスタムを選択して、カスタムの日数を指定します（最小1日）。

4

Configure Subscription Settings (Optional)

これらの設定は、定期サブスクリプション内でのクレジットの動作を制御します：

​

Rollover

boolean

未使用クレジットを次の請求サイクルに持ち越すことを許可します。有効にすると、次のことを構成します：

• 最大繰り越し率（0〜100％）-どれだけのクレジットが持ち越されるかを制限
• 繰り越し期間 - 繰り越されたクレジットの有効期限（例：1か月）
• 最大繰り越しカウント - クレジットが失効する前に連続して繰り越しできる最大回数

クレジットが無くなるかサブスクリプションが失効した場合:

​

Allow Overage

boolean

クレジットバランスがゼロに達しても顧客がサービスを使い続けることを許可します。有効にすると、次のことを構成します：

• 超過制限 - 顧客がバランスを超えて消費できる最大クレジット
• 単価 - 超過が有効なときの追加クレジットのコスト（通貨セレクターと共に）

​

Overage Behavior

string

必須

請求サイクルの終わりにおける超過の処理方法：

• リセット時に超過を許容する（デフォルト） - クレジット制限を超えた使用は追跡されるが、請求されず、各サイクル毎に残高がリセットされる。
• 請求時に超過を請求 - クレジット制限を超えた使用は次の請求書で請求され、その後残高がリセットされる。
• 不足分を持ち越す - クレジット制限を超えた使用は次のサイクルへとマイナス残高として持ち越される。
• 自動返済付き不足分の持ち越し - 不足は持ち越され、次のサイクルで新しいクレジットから自動的に返済される。

5

Create Credit

Create Credit をクリックして保存します。クレジットは今後のどの製品にもアタッチ可能になります。

クレジット権利が準備できました。製品にアタッチして、顧客にクレジットを発行し始めましょう。

​

クレジットを製品にアタッチする

​

サブスクリプション製品

1

Create or Edit a Subscription Product

Products → Create Product に移動するか、既存の製品を編集します。サブスクリプションを価格タイプとして選択し、定期価格を設定します。

2

Open Entitlements Section

エンタイトルメントセクションを展開し、クレジットの横にあるアタッチボタンをクリックします。

3

Select Credits to Attach

Add Creditsパネルが開きます。ドロップダウンから既存のクレジットを選択するか、その場でクレジットを定義するための新しいクレジットを作成をクリックします。

1つの製品につき最大3つのクレジットをアタッチできます。それぞれのクレジットには独自の設定が可能です。

4

Configure Credit Settings

各アタッチされたクレジットについて構成します：

​

Credits issued per billing cycle

number

必須

顧客に各請求期間に付与されるクレジットの数。

​

Low Balance Threshold

number

クレジットがこの金額を下回ったときに通知します。顧客が使い切る前にアラートを送るのに役立ちます。

​

Credits During Free Trial

number

試用期間に別のクレジット量を設定します。試用終了後に試用クレジットを失効させるを有効にして試用終了時に未使用の試用クレジットを取り消します。

​

Allow Proration

boolean

顧客がサブスクリプションプランをアップグレードまたはダウングレードする際、残りのクレジットを比例配分します。

​

Import Default Credit Settings

boolean

クレジット権利のデフォルトの繰越、超過、および有効期限設定を使用します。この製品特有の設定をカスタマイズするにはオフにします。

5

Review and Add

アタッチされたクレジットを確認し、名前、量、有効期限を表示します。サブスクリプションに追加をクリックして確認してください。

​

一回限りの支払い製品

1

Create a One-Time Product

シングルペイメント価格タイプの製品を作成します。

2

Attach Credits

エンタイトルメントセクションを開いてクレジットをアタッチします。購入時に付与されるクレジットの量（総一回限りの付与）を構成します。

​

使用量ベースの請求製品

1

Create a Usage-Based Product

Usage Based Billingを価格タイプとして選択します。基本価格と請求頻度を構成します。

2

Add a Meter

メーターを選択セクションで**+ボタンをクリックしてメーターを追加します。サブスクリプションには最大3つのメーター**を追加できます。

3

Enable Credit Billing on the Meter

クレジットで使用量を請求をトグルしてメーターにクレジットをアタッチします。ドロップダウンからクレジット権利を選択します。

​

Free Threshold

number

必須

クレジット差し引きが始まる前に無料とされる単位数。

​

Bill usage in Credits

boolean

有効にすると、メーター使用量は顧客のクレジットバランスから差し引かれ、1単位ごとに請求されません。

​

Meter units per credit

number

必須

1クレジットを差し引くのに必要な使用単位数。例えば、1000 に設定した場合、1,000回のAPIコールが1クレジットを消費します。

4

Configure Credit Issuance

発行されるクレジットの数を設定し、オプションでこの製品にクレジット設定をカスタマイズします。

5

Verify Attachment

構成すると、メーターはアタッチされたクレジット名、単価、無料しきい値を表示します。

​

クレジット設定

​

繰越

​

超過

​

失効

​

クレジットを使用した課金

​

メーターに基づくクレジット差し引きの仕組み

1. アプリケーションが使用量イベントを送信 - 各イベントには顧客ID、イベント名、およびメタデータが含まれます
2. メーターがイベントを集計 - Count, Sum, Max, Last, または Unique Count 集計を使用
3. クレジットが自動的に差し引かれる - バックグラウンドワーカーが毎分イベントを処理し、メーター単位を設定されたレートでクレジットに変換し、FIFOオーダリング（古い付与から順に）で顧客のバランスから差し引きます
4. 超過が追跡される - クレジット残高がゼロに達し、超過が有効な場合、システムは請求サイクルの終了時に超過使用を追跡します

​

メーターパネル

​

カスタマーエクスペリエンス

​

チェックアウト

​

カスタマーポータル

• 利用可能残高 - 現在のクレジット残高が目立つように表示されます
• クレジットタブ - 異なるクレジットタイプ（例：「OpenAIクレジット」、「使用トークン」）間の切り替え
• 最近のトランザクション - 日付、トランザクションID、タイプ、額、およびランニングバランスの完全な履歴

​

サブスクリプション詳細

• 請求サイクルごとのクレジット割当（例：「各サイクル1000クレジット」）
• 残りのバランス（例：「7500クレジット残り」）
• 次回のクレジット発行の更新日
• 使用履歴 タブには、消費された単位数、しきい値、単価、総コストを示すメーター単位での内訳を表示

​

トランザクション詳細

​

クレジットの管理

​

ダッシュボードビュー

​

クレジット権利のリスト

​

顧客クレジット詳細

• クレジットセレクター - 異なるクレジット権利間を切り替え
• 利用可能残高 - 大きく目立つ表示の現在の残高
• クレジット/デビットの適用 - 顧客の残高を手動で調整するボタン
• 最近のトランザクション - 日付、トランザクションID、タイプ、額、およびランニングバランスを示す完全な台帳

​

手動調整

​

クレジット帳簿

​

Webhooks

​

API管理

​

統合例

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
  environment: 'test_mode', // defaults to 'live_mode'
});

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_ai_pro_plan',
      quantity: 1,
    }
  ],
  customer: { email: 'customer@example.com' },
  return_url: 'https://yourapp.com/success'
});

await client.usageEvents.ingest({
  events: [{
    event_id: `gen_${Date.now()}`,
    customer_id: 'cus_abc123',
    event_name: 'ai.generation',
    timestamp: new Date().toISOString(),
    metadata: { model: 'gpt-4', tokens: 1500 }
  }]
});

​

実際の例

​

ベストプラクティス

• シンプルに始める: 単一のクレジットタイプと繰越なしで始めましょう。顧客のフィードバックと使用パターンに基づいて複雑さを追加します。
• 明確な期待を設定: 製品ページと顧客ポータルにクレジット配布、残りの残高、超過価格を目立つように表示します。
• 意味のある単位を使用: クレジットが何を表すかに基づいて名前を付けましょう（例：「APIコール」、「AIトークン」）- 顧客が価値を理解するのに役立ちます。
• 慎重に有効期限を設定: 短い有効期限ウィンドウ（7日）は緊急性を生むが、顧客を苛立たせる可能性があります。長いウィンドウ（30〜90日）がほとんどのSaaS製品に対してより顧客に優しいです。
• 低残高を監視: 顧客がクレジットを使い切る前に警告を送るために低残高しきい値を設定し、意外な超過請求を減少させます。
• テストモードでテスト: クレジットを作成し、テスト製品にアタッチし、フルな購入→使用→差し引き→失効サイクルをライブ開始前にシミュレーションします。