使用量に基づく請求は、顧客が実際に使用した分（APIコール、ストレージ、AIトークン、または定義した任意のメトリック）に対して請求することを可能にします。顧客は消費に対して支払い、固定料金はありません。
Perfect for: 使用量に応じて価値がスケールする API、AI サービス、インフラプラットフォーム、およびあらゆる製品に適しています。
仕組み
Send Usage Events
課金対象アクションが発生したらアプリケーションがイベントを送信します。{
"event_id": "evt_123",
"customer_id": "cus_abc",
"event_name": "api.call",
"metadata": { "endpoint": "/v1/users" }
}
Meters Aggregate Usage
メーターは Count、Sum、Max、Last の集計方式を使用してイベントを課金対象の量にまとめます。
Automatic Billing
単位ごとの価格と無料の閾値を設定します。顧客は各サイクルで自動的に請求されます。
コア概念
イベント
イベントは使用アクションを表します。各イベントには:
- Event Name: 使用タイプ (例:
api.call)
- Customer ID: 利用した顧客
- Metadata: 集計用の追加プロパティ
メーター
メーターは、イベントを請求可能な数量に集計します:
- カウント: 総イベント数（APIコール）
- 合計: 値を加算（総バイト数）
- 最大: 最高値（ピークユーザー数）
- 最新: 最も最近の値
使用量に基づく価格設定のある製品
単位ごとの価格とオプションの無料閾値を設定します:
例: 2,500コール - 1,000無料 = 1,500 × 0.02=30.00
クレジットベースの差し引き
ドル単位で課金する代わりに、メーターを構成して顧客のクレジット残高から差し引かれるようにできます。クレジットは各請求サイクルでリフレッシュされ、超過料金より前に適用されます。
クイックスタート
Create a Meter
ダッシュボードで: Meters → Create Meter
- イベント名を設定 (例:
api.call)
- 集計方式を選択 (Count、Sum、Max、Last)
- 必要に応じてフィルターを追加
Add to Product
価格設定された製品にメーターをリンク:
- Usage-Based Billing を選択
- 使用するメーターを選択
- 単価と無料閾値を設定
Send Events
await fetch('https://test.dodopayments.com/events/ingest', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.DODO_PAYMENTS_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
events: [{
event_id: "unique_event_id",
customer_id: "cus_abc123",
event_name: "api.call",
metadata: { endpoint: "/v1/users" }
}]
})
});
Monitor Usage
メーターのダッシュボードでイベントと使用量集計を確認します。顧客は各サイクルで自動的に請求されます。 ユースケース
APIs & Infrastructure
API コール、コンピュート時間、帯域幅、ストレージを追跡します。例: 10,000 回の無料後、1 回あたり $0.001。
AI Usage Tracking
トークン、生成、処理時間を追跡します。例: 標準画像 0.04、HD0.08。 Data & Analytics
処理データ量、実行クエリ、分析レコードごとに課金。例: 10 GB の無料後は 1 GB あたり $5。
Communication
メッセージ、分数、転送データをカウント。例: 送信 SMS 1 件あたり $0.01。
次のステップ
