従量課金をモデル化するレガシー

従量課金のモデルでは、ユーザー数単位や定額制の料金体系モデルのように明示的に数量を設定するのではなく、請求サイクル内に使用したサービスの数量に応じて顧客に請求します (ユーザー数単位や定額制のモデルとのもう 1 つの相違点は、これらのモデルでは請求サイクルの支払いを必要に応じて事前に回収できることです。使用量に基づく請求では事後に請求することになります)。また、使用量を記録して報告する必要もあります。

Togethere では、新しい会議サービスの使用に対して分単位で請求し、使用時間が長いほど顧客の 1 分あたりの料金を下げたいと考えています。

これを Stripe で表すと、次のようなモデルになります。

従量課金の料金体系モデル

利用タイプ

継続購入の場合、licensed または metered のいずれかの usage_types を使用して、顧客への請求額を定義します。

パッケージと標準の料金体系

ダッシュボードで、料金体系モデルとして標準の料金体系またはパッケージ料金体系を選択できます。これらのモデルはどちらもライセンス型 (recurring[usage_type]='licensed') の使用量タイプにマッピングされます。どちらのモデルでも、サブスクリプションの作成または更新時に単位数を指定できます。以下に両モデルの相違点を示します。

• 標準の料金体系では、数量はデフォルトで 1 になります。
• パッケージ料金体系では、単価に 2 以上の値を設定します。

Stripe で従量課金の料金体系をモデル化する

次の例は、使用量に基づく料金体系モデルを作成する方法を示しています。この例の場合、Togethere は 1 分あたり 0.07 USD を請求します。

サブスクリプションの導入ガイドでは、実装全体に合わせて料金体系モデルを調整する方法を説明しています。

• Stripe Checkout を使用している場合、次のステップはサイトの Checkout セッションの作成になります。Stripe の設定が完了していることを確認してください。
• Stripe Elements を使用している場合、次のステップは Customer の作成になります。Stripe とサンプルアプリケーションの設定が完了していることを確認してください。

従量課金のその他のバージョンについては、高度なモデルのセクションをご覧ください。また、従量課金の無料トライアルやその他の機能の導入方法についてもご覧いただけます。

高度な料金モデル

定額料金とユーザー数単位の料金

2 つの別々の商品に顧客を登録することで、基本料金とユーザー数単位の追加料金の両方が含まれる料金体系をモデル化できます。一方の商品で定額の基本料金を表し、もう一方の商品で変動するユーザー数単位の料金を表します。

Togethere は、サービスに対する定額の月額料金と、50 人を超えるユーザー向けの段階制料金を請求します。

Stripe で定額料金とユーザー数単位の料金体系をモデル化する

Stripe でこの構造をモデル化するため、Togethere は基本料金の商品と料金を作成します。

curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d nickname="Monthly Base Fee" \
  -d product={{BASE_FEE_PRODUCT_ID}} \
  -d unit_amount=500 \
  -d currency=usd \
  -d "recurring[interval]"=month \
  -d "recurring[usage_type]"=licensed

次に、1 ユーザーあたり 15 USD を請求する月額料金を作成します。

curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d nickname="Per-seat price" \
  -d product={{PRODUCT_ID}} \
  -d unit_amount=1500 \
  -d currency=usd \
  -d "recurring[interval]"=month \
  -d "recurring[usage_type]"=licensed

以下は、3 人のユーザーを持つ顧客に対して、基本料金と、ユーザー単位の料金のサブスクリプションを設定する方法を示しています。

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"={{BASE_FEE_PRICE_ID}} \
  -d "items[0][quantity]"=1 \
  -d "items[1][price]"={{PER_SEAT_PRICE_ID}} \
  -d "items[1][quantity]"=3

これにより、5 USD の基本月額料金と、3 人のユーザーそれぞれに対する 15 USD の請求で、毎月 50 USD の請求が発生します。

定額料金と使用量に基づく料金

定額料金と使用量に基づく料金を組み合わせて、請求サイクル中の使用量に対する請求に加えて、定額の月額料金を請求することもできます。

Product (商品) と Price (価格) API を使用して、Stripe で定額 + 使用量に基づく料金体系モデルを作成するには、以下のようにします。

1. Flat monthly fee 商品を作成します。

   Command Line

   cURL

   curl https://api.stripe.com/v1/products \
     -u "
   sk_test_BQokikJOvBiI2HlWgH4olfQ2
   :" \
     -d name=Per-seat

2. Flat monthly fee 商品の料金を作成します。

   Command Line

   cURL

   curl https://api.stripe.com/v1/prices \
     -u "
   sk_test_BQokikJOvBiI2HlWgH4olfQ2
   :" \
     -d product=
   {{PRODUCT_ID}} \
     -d unit_amount=1000 \
     -d currency=usd \
     -d "recurring[interval]"=month

3. Meeting per minute usage 料金を作成します。

   Command Line

   cURL

   curl https://api.stripe.com/v1/prices \
     -u "
   sk_test_BQokikJOvBiI2HlWgH4olfQ2
   :" \
     -d nickname="Metered Monthly Plan" \
     -d product={{PRODUCT_ID}} \
     -d unit_amount=700 \
     -d currency=usd \
     -d "recurring[interval]"=month \
     -d "recurring[usage_type]"=metered

サブスクリプションを作成する際に、両方の料金 ID を指定します。

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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}} \
  -d "items[1][quantity]"=1

小数を使用する金額

小数を使用する料金は、整数ではない料金の金額を作成する必要がある場合に利用できます。たとえば、クラウドストレージの SaaS ビジネスを運営している場合、1 カ月につき、1 MB あたり 0.05 セントを請求する料金を作成できます。使用量を基準にして MB の数量に 0.05 セントを乗じて、最も近い整数のセントに端数処理します。

小数を使用するオブジェクトを作成する

小数を持つ価格を作成するには、unit_amount ではなく、unit_amount_decimal を指定します。unit_amount_decimal を使用すると、請求通貨の補助単位を使用して金額を設定できます。たとえば、USD で unit_amount_decimal = 105.5 と設定すると、105.5 セント (1.055 USD) と表すことができます。unit_amount_decimal では、小数点以下最大 12 桁まで使用できます。

段階制料金の使用を予定している場合は、unit_amount ではなく unit_amount_decimal を使用します。また、unit_amount の代わりに unit_amount_decimal を使用して請求書アイテムを作成することもできます。

API レスポンスでは、オブジェクトが小数点付きの値で作成されると、整数 unit_amount フィールドには入力されません。たとえば、unit_amount_decimal = 0.05 で価格を作成すると、レスポンスには unit_amount = null と unit_amount_decimal = 0.05 が含まれます。unit_amount_decimal には整数値を渡すこともでき、その場合はレスポンスの unit_amount に入力されます。たとえば、unit_amount_decimal = 5 で価格を作成すると、レスポンスには unit_amount = 5 と unit_amount_decimal = 5.0 が含まれます。