レートカードを管理する非公開プレビュー

このガイドでは、レートカードを使用する従量制課金の設定の更新と管理の方法、個別の請求期間とサービス期間の作成方法、すべての登録者への新しいサービスの導入方法、ユーザーコホートごとの料金バージョンの設定方法について説明します。

請求頻度とサービス期間を別々に設定する

使用量を週単位 (サービス期間) で評価することで、使用状況に関するインサイトを短いスパンで顧客に提供できます。ただし、管理コストを削減するために、請求書の作成は月単位 (請求頻度) に設定します。

サービス期間と請求頻度を別々に定義することで、使用量を集約し、ある頻度 (毎週など) でアクセスをプロビジョニングし、顧客には別の頻度 (毎月など) で請求する柔軟性が得られます。これは、キャッシュフローのニーズを最適化するのに役立ちます。

ノーコードですべての登録者に新しいサービスを展開

新しい料金で新機能をリリースした場合、レートカードに新しい料金を追加することで、その料金をすべての登録者に展開できます。本番環境バージョンのすべてのサブスクリプション登録者は、追加した新しいサービスにアクセスでき、新しい料金がすぐに適用されます。

レートカードに新しいレートを追加すると、そのバージョンのすべての登録者に対してすぐに利用可能になります。新しいレートのメーターに対して報告された使用量は、請求サイクルの途中で追加した場合でも、このレートに従って料金が設定されます。これにより、コードを記述することなく、新しい課金対象サービス (新しい AI モデルなど) をすばやく立ち上げることができます。

ダッシュボードから既存のレートカードに新しいレートを追加するには:

1. レートカードページに移動します。
2. レートカードを選択し、レートカードを編集 をクリックします。
3. をクリックして、新しい料金を追加します。

ユーザーコホートごとの価格バージョンの設定

レートカードでは、バージョニングを使用して料金体系の管理を柔軟に行うことができます。レートカードを作成すると、最初の本番バージョンが新規登録者のデフォルトとして自動的に設定されます。新しい料金をレートカードに追加しても、新しいバージョンは作成されません。既存のレートを変更または削除した場合のみ、新しいバージョンが作成されます。本番環境バージョンを手動で変更するまで、元のバージョンは本番環境のままです。

顧客コホートごとに異なる料金体系を提供するには、次のようにします。

1. レートカードの現在の本番環境バージョン (デフォルト) を新規顧客に登録します。
2. 顧客セグメントごとに異なるバージョンを作成します。
3. 特定の顧客を古いバージョンに登録します。

レートカードのサブスクリプションを作成する際に、使用するバージョンを指定できます。

curl -X POST https://api.stripe.com/v2/billing/rate_card_subscriptions \
  -H "Authorization: Bearer 
{{YOUR_API_KEY}}
" \
  -H "Stripe-Version: 2025-05-28.preview" \
  --json '{
    "rate_card": "rcd_A",
    "billing_cadence": "bc_1",
    "rate_card_version": "rcdv_123"
  }'

バージョンを指定しない場合、Stripe は自動的に現在の本番環境バージョンを使用します。

新規または更新されたレートカードに顧客を移行する

既存の登録者のバージョンを変更するには、その登録者のレートカードのサブスクリプションをキャンセルし、新しいバージョンで新しい登録者を作成する必要があります。既存の顧客を、新規のレートカードまたは新しいバージョンのレートカードに移行できます。これを行うには、古いレートカードまたはレートカードバージョンを使用している既存のサブスクリプションをキャンセルします。次に、新しいレートカードまたはレートカードのバージョンに顧客を登録します。

レートカードのサブスクリプションをキャンセルする

レートカードのサブスクリプションをキャンセルするには:

• ダッシュボードでレートカードのサブスクリプションページに移動し、キャンセルするレートカードを選択します。サブスクリプションの右側にあるオーバーフローメニュー () をクリックし、キャンセル を選択します。
• API を使用するには、Cancel a rate card subscription エンドポイントにリクエストします。

curl -X POST https://api.stripe.com/v2/billing/rate_card_subscriptions/{{RATE_CARD_SUBSCRIPTION_ID}}/cancel \
  -H "Authorization: Bearer 
{{YOUR_API_KEY}}
" \
  -H "Stripe-Version: 2025-05-28.preview"