# 単純従量課金制モデルの設定

単純従量課金制モデルを設定します。

単純従量課金制では、顧客が貴社の商品またはサービスをどのくらい使用したかに応じて請求します。単純従量課金制には、以下のようなモデルがあります。

- [定額料金と超過料金](https://docs.stripe.com/subscriptions/pricing-models/usage-based-pricing.md#fixed-fee-overage)
- [後払い従量制](https://docs.stripe.com/subscriptions/pricing-models/usage-based-pricing.md#pay-as-you-go)
- [クレジットバーンダウン](https://docs.stripe.com/subscriptions/pricing-models/usage-based-pricing.md#credit-burndown)

## 定額手数料と超過料金

固定料金と超過料金モデルを使用して、期間の開始時にサービスに対する月額定額料金を請求します。定額料金には一定の使用権が含まれており、追加の使用量 (超過分) は期間の終了時に請求されます。

Stripe ダッシュボードまたは API を使用して、同じ商品内で 2 つの価格でこれを設定できます。たとえば、Hypernian という AI 事業者は Hypernian Pro と呼ばれる高度なモデルを導入しています。このモデルの価格は月額 200 USD で、100,000 トークンが含まれています。含まれるトークンを超える使用量には、トークンごとに 0.001 USD の追加料金が課金されます。

#### ダッシュボード

1. [商品カタログ](https://dashboard.stripe.com/test/products)ページで、**商品を作成**をクリックします。

1. **商品を追加** ページで、以下を実行します。

   - **名前** に、製品の名前を入力します。Hypernian の例には、「Hypernian」と入力します。
   - (オプション) **説明**には、[カスタマーポータル](https://docs.stripe.com/customer-management.md)と[見積もり](https://docs.stripe.com/quotes.md)で決済時に表示する説明を追加します。
   - **請求期間** で、**その他の料金体系オプション** を選択します。

1. **価格を追加** ページで、以下を実行します。

   - **料金モデルを選択**で、**定額制**を選択します。
   - **価格** で **金額** を undefined USD に設定します。
   - **次へ**をクリックします。

1. プロダクトに 2 つ目の継続価格を追加するには、**商品を追加**ページで**別の価格を追加**をクリックします。

1. **価格を追加** ページで、以下を実行します。

   - **料金モデルを選択**で、**使用量ベース**、**段階レベルごと**、**段階制**を選択します。

   - **価格**で、2 つの段階的な料金を作成します。

|            | 下限ユニット  | 上限ユニット  | ユニットあたり   | 定額課金  |
| ---------- | ------- | ------- | --------- | ----- |
| **第 1 段階** | 0       | 100,000 | 0 USD     | 0 USD |
| **第 2 段階** | 100,001 | ∞       | 0.001 USD | 0 USD |

1. **メーター** で、使用状況を記録する新しいメーターを作成します。Hypernian の例では、メーター名「hypernian_api_tokens」を使用します。

1. **次へ**をクリックします。

1. **商品を追加**をクリックします。サブスクリプションを作成するときに、両方の料金を指定します。

#### API

まず、[製品](https://docs.stripe.com/api/products.md).を作成します。Hypernian の例では、`Hypernian tokens` という名前を使用します。

```curl
curl https://api.stripe.com/v1/products \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "name=Hypernian tokens"
```

次に、定額料金 [price](https://docs.stripe.com/api/prices.md)をライセンスレート 200 USD の製品に追加します。

```curl
curl https://api.stripe.com/v1/prices \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d product={{PRODUCT_ID}} \
  -d currency=usd \
  -d unit_amount=20000 \
  -d billing_scheme=per_unit \
  -d "recurring[usage_type]=licensed" \
  -d "recurring[interval]=month"
```

その後、2 段階で 2 つの段階的なレートを設定した従量制の料金をプロダクトに追加します。

最初の段階では、0 ～ 100,000 ユニットを 1 ユニットあたり 0 USD に設定します。第 2 段階では、1 ユニットあたり 0.001 USD を指定します。最初の段階の価格は 0 USD です。これは、固定料金に最初の 100,000 ユニットが含まれているためです。

```curl
curl https://api.stripe.com/v1/prices \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d product={{PRODUCT_ID}} \
  -d currency=usd \
  -d billing_scheme=tiered \
  -d "recurring[usage_type]=metered" \
  -d "recurring[interval]=month" \
  -d "recurring[meter]={{METER_ID}}" \
  -d tiers_mode=graduated \
  -d "tiers[0][up_to]=100000" \
  -d "tiers[0][unit_amount_decimal]=0" \
  -d "tiers[1][up_to]=inf" \
  -d "tiers[1][unit_amount_decimal]=0.1"
```

最後に、[サブスクリプションを作成](https://docs.stripe.com/billing/subscriptions/usage-based/implementation-guide.md#create-subscription)するときに、両方の価格 ID を指定します。

```curl
curl https://api.stripe.com/v1/subscriptions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d customer={{CUSTOMER_ID}} \
  -d "items[0][price]={{FLAT_MONTHLY_FEE_PRICE_ID}}" \
  -d "items[0][quantity]=1" \
  -d "items[1][price]={{METERED_USAGE_PRICE_ID}}"
```

## 従量課金プラン

従量課金モデル (後払いとも呼ぶ) では、一定期間に発生した使用量を追跡し、期間の終了時に顧客に請求します。

次の料金体系戦略のいずれかを使用できます。

- **ユニットあたり**: 各ユニットに同じ料金を請求します。
- **パッケージあたり**: ユニットや使用量のパッケージまたはバンドルに対して料金を請求します。
- **従量ベースの料金体系**: 期間終了時の使用量に対応する段階の料金でサブスクリプションアイテムに請求します。
- **段階的な料金体系**: すべての使用量に単一の料金を適用するのではなく、各段階の使用量に応じて請求します。

このモデルでは、顧客の使用量が大量に累積され、月末の決済手段のステータスに影響を与える可能性があります。

## クレジットバーンダウンモデル (初期金額を使用量に応じて段階的に消費するモデル)

クレジットバーンダウンモデルでは、使用量ベースのプロダクトとサービスの前払いを回収できます。顧客は[請求クレジット](https://docs.stripe.com/billing/subscriptions/usage-based/billing-credits.md)を使用して初期金額を支払い、その後、プロダクトの使用時に請求クレジットを適用できます。

たとえば、Hypernian は、新しい Hypernian モデルの既存のセルフサービス顧客に大規模な企業契約を販売したいと考えています。顧客は、Hypernian に対して 100000 USD を前払いすることを約束し、1 年以内に使用する請求クレジットの使用量として 120000 USD を取得できるようにします。

#### ダッシュボード

#### 顧客から前払いを回収する

1. [請求書](https://dashboard.stripe.com/invoices)ページで、**請求書を作成**をクリックします。
1. **Customer** ドロップダウンから、対象の顧客を選択します。
1. **通貨**ドロップダウンから正しい通貨を選択してください。
1. **アイテム**で、**新しいラインアイテムを追加**を選択します。
1. **アイテムの詳細**で、次の操作を行います。
   - **アイテム** に「Hypernian Credits」と入力します。
   - **価格** に「100,000」と入力します
   - **保存**をクリックします。
1. **請求書を送信する**をクリックします。

顧客が請求書を支払った後で、請求クレジットを付与できます。

#### 顧客に請求クレジットを付与する

1. [顧客](https://dashboard.stripe.com/test/customers) ページで、顧客名を選択します。
1. 顧客ページの **クレジット付与** でプラス (**+**) 記号をクリックします。
1. **新しいクレジット付与** ページで、以下を実行します。
   - **名前** には、クレジット付与の名前を入力します。
   - **金額** に、クレジット付与の金額を指定します。Hypernian の例には、「120,000」と入力します。
   - **有効期限** で、クレジットの有効期限が切れる日付 (ある場合) を指定します。Hypernian の例では、 **特定の日付** を選択し、今から 12 か月後の日付を設定します。
   - **クレジット付与を作成** をクリックします。

#### API

最初に、請求書を作成します。

```curl
curl https://api.stripe.com/v1/invoices \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "description=Hypernian Credits" \
  -d customer={{CUSTOMER_ID}} \
  -d collection_method=charge_automatically
```

次に、請求クレジットを請求書に追加します。

```curl
curl https://api.stripe.com/v1/invoiceitems \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d customer={{CUSTOMER_ID}} \
  -d currency=usd \
  -d unit_amount_decimal=10000000 \
  -d invoice={{INVOICE_ID}}
```

次に、請求書を確定します。

```curl
curl https://api.stripe.com/v1/invoices/{{INVOICE_ID}}/finalize \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d auto_advance=true
```

顧客が請求書を支払った後で、請求クレジットを付与できます。

```curl
curl https://api.stripe.com/v1/billing/credit_grants \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d customer={{CUSTOMER_ID}} \
  -d category=paid \
  -d "amount[type]=monetary" \
  -d "amount[monetary][value]=12000000" \
  -d "amount[monetary][currency]=usd" \
  -d "applicability_config[scope][price_type]=metered" \
  -d expires_at=1759341179
```