コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
AI に質問する
アカウントを作成
サインイン
始める
支払い
財務の自動化
プラットフォームおよびマーケットプレイス
資金管理
開発者向けのツール
始める
支払い
財務の自動化
始める
支払い
財務の自動化
プラットフォームおよびマーケットプレイス
資金管理
概要
Billing
    概要
    Billing API について
    サブスクリプション
    Invoicing
    従量課金
      従量課金の設定を選択する
        商品と価格を使用する
        レートカードを使用する
          レートカードの仕組み
          レートカードのサブスクリプションの仕組み
          レートカードの設定を管理する
      請求する使用量を記録
      請求クレジットを提供する
      使用量を監視する
      従量課金モデル
    Connect と Billing
    Tax と Billing
    見積もり
    売上回収
    オートメーション
    スクリプト
    収益認識
    顧客管理
    エンタイトルメント
    実装内容をテストする
税金
レポート機能
データ
スタートアップの企業設立
ホーム財務の自動化BillingUsage-based billingChoose a usage-based billing setup

注

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

レートカードを使用した従量課金の設定非公開プレビュー

レートカードを使用して、商品やサービスの使用量に基づいて顧客に請求します。

ページをコピー

1 つのレートカードを使用して、従量課金制サービスのさまざまな料金のサブスクリプションに顧客を登録できます。レートカードに新しいレートを追加すると、その新しいレートをすぐに顧客に適用できます。レートカードはバージョン管理されているため、既存顧客のレートを維持しながら、新規顧客のレートを調整できます。

プライベートプレビュー

レートカードは現在非公開ベータ版でのみ利用可能であり、すべての Stripe ユーザーを対象とした一般提供が開始されるまでに、機能や実装手順が変更される可能性があります。お問い合わせ登録はこちら to request access.

はじめに

レートカードの /v2 API エンドポイント (Rate cards subscriptions など)。/v2 名前空間と /v1 名前空間の詳細については、こちらのページをご覧ください。

/v2 API の サンドボックスのみを使用できます。

レートカードを作成する

Stripe ダッシュボードまたは API を使用して、複数の料金と料金オプションを記載したレートカードを作成します。

レートカードごとに次の設定を行うことができます。

  • サービス期間:1 カ月、1 年、1 週間、またはカスタム。
  • 通貨
  • 価格に税金を含める

レートカードの各項目に対して、次の設定を行うことができます。

  • メーター:使用量の記録に使用するメーター。
  • 価格タイプ:固定料金、数量ベース、段階制料金。
  • 販売方法:個別のユニット、またはひとまとまりのユニット (パッケージ) による請求。パッケージを適用する場合は、パッケージごとのユニット数と、パッケージの端数の処理方法 (切り上げまたは切り捨て) を指定します。
  • 高度な設定:必要に応じて、商品税コードを指定できます。単位ラベル、検索キー、メタデータ、料金設定のメタデータを追加することも可能です。

レートカードの各料金は、メーターに関連付ける必要があります。

  1. レートカードページに移動します。+ レートカードを作成をクリックします。
  2. レートカードエディタで、レートカードを設定します。
    • レートカード名:レートカードの名前を追加します。ここでは Alpaca AI を使用します。
    • サービス期間:顧客の使用量を集計して価格を設定する期間を選択します。詳しくは、サービス期間をご覧ください。
    • 通貨:通貨を選択します。
    • 税金処理:価格に税金を含めるかどうかを選択します。デフォルトでは、価格に税金は含まれて_いません_。詳細については、税金処理とレートカードをご覧ください。
    • 続行をクリックします。
  3. レートカードエディタの次の画面で、メーター項目を追加します。
    • メーター項目:項目名を入力します。例として、Alpaca AI tokens を使用します。
    • メーター: 既存の メーター を選択するか、+ をクリックして新しいメーターを作成します。
    • 価格設定:価格タイプを選択します。固定料金、数量、または段階から選択可能です。Alpaca AI は固定料金を使用すると仮定します。
      • 販売方法 では、個別のユニットとして販売するか、ひとまとまりのユニット (パッケージ) として販売するかを選択します。たとえば、AI 企業は、トークンを 100 ユニットのパッケージとして、パッケージあたり 0.04 USD で販売する場合があります。
      • パッケージの場合は、パッケージの単価を入力します。
      • パッケージの端数 を切り上げるか切り捨てるかを選択します。切り上げた場合、110 ユニットを使用するユーザーには 0.08 USD が請求されます。
      • パッケージ価格を入力します。
    • (任意) 必要に応じて、商品税コード (詳しくは、税コードをご覧ください)、単位ラベル、検索キー、メタデータ などを指定して、アイテムの 詳細設定 を保存できます。料金にメタデータを追加することもできます。
    • 保存をクリックします。
  4. をクリックすると、別の料金を追加することができます。
  5. レートカードを作成をクリックします。

顧客をレートカードに登録する

サブスクリプションを作成する前に、Customer (顧客) オブジェクトを作成し、請求先情報を指定する必要があります。これは、ダッシュボード、API、または Stripe Checkout を使用して実行できます。

ダッシュボードで手動で顧客を作成し、請求先情報を追加します。または、レートカードのサブスクリプションを作成するときに顧客を作成できます。

  1. レートカードページに移動し、顧客に登録するレートカードをクリックします。
  2. レートカードの詳細ページで、レートカードの編集の横にあるオーバーフローメニュー () をクリックします。
  3. レートカードのサブスクリプションエディタで、次の操作を行います。
    • 顧客を検索または追加します。
    • 請求頻度を定義します。請求頻度は、顧客に請求書を送信する頻度とタイミングのことを指します。
    • サブスクリプションの作成をクリックします。

顧客の使用状況を記録する

顧客をレートカードに登録した後、メーターにメーターイベントを送信することで、サービスの使用量を記録できます。

  1. レートカードのサブスクリプションタブに移動します。
  2. 使用量を記録するサブスクリプションをクリックします。
  3. 使用量を記録する項目の行にあるオーバーフローメニュー () をクリックし、メーターの詳細を表示をクリックします。
  4. メーターの詳細ページで、+ 使用量を追加をクリックし、使用量を手動で入力を選択します。
  5. 使用量の追加ダイアログで、次の操作を行います。
    • 顧客を選択します。
    • 使用量の値を入力します。
    • タイムスタンプの日付を選択します。
  6. 送信をクリックします。

請求書プレビューを作成する

請求書のプレビューを作成して、メーターの料金や使用量などの詳細を含む、顧客の請求書のプレビューを確認します。

  1. レートカードのサブスクリプションタブに移動します。

  2. 請求書をプレビューするサブスクリプションをクリックします。

  3. 次回の請求書 セクションまで下にスクロールします。請求書のプレビューには、指定した日付に顧客に請求するサブスクリプションの金額が表示されます。

  4. 請求書の全文を表示 をクリックすると、次の請求書の詳細が表示されます。

    • 顧客
    • 請求方法
    • 作成日
    • 連携されたサブスクリプション
    • サブスクリプションの詳細 (使用量とメーター料金)
    • 請求金額

    Stripe はメーターイベントを非同期で処理するため、次回のインボイスに最近受信したメーターイベントがすぐに反映されない場合があります。

サービスイベントを監視する

レートカードのサブスクリプションは、サービスステータスが変更されるたびにイベント通知を発行します。詳しくは、サービス期間の仕組みをご覧ください。

これらのイベントをリッスンし、それらを使用してビジネスロジックを構築します。

v2.billing.rate_card_subscription.servicing_activated顧客がサブスクリプションを初めて有効にしたときに送信されます。
v2.billing.rate_card_subscription.servicing_paused顧客がサブスクリプションを一時停止したときに送信されます。
v2.billing.rate_card_subscription.servicing_canceled顧客がサブスクリプションをキャンセルしたときに送信されます。

これらの v2 イベント を処理するには、イベントの送信先を設定し、Webhook エンドポイントを指定します。このとき、次のいずれかを実行できます。

  • Workbench から Event Destination を作成します。
  • Stripe API を経由して Event Destination を作成します。

送信先を作成したら、次のイベントを処理するように Webhook エンドポイントを設定できます。

server.rb
require 'stripe' post '/v2_webhook_endpoint' do payload = request.body.read sig_header = request.env['HTTP_STRIPE_SIGNATURE'] event = nil begin event = Stripe::Webhook.construct_event( payload, sig_header, endpoint_secret ) rescue JSON::ParserError => e status 400 return rescue Stripe::SignatureVerificationError => e status 400 return end client = Stripe::StripeClient(
"sk_test_BQokikJOvBiI2HlWgH4olfQ2"
) case event.type when 'v2.billing.rate_card_subscription.servicing_activated' # The customer clicked Pay on Stripe Checkout, which activates the service. subscription_id = event.related_object.id subscription = client.v2.billing.rate_card_subscriptions .retrieve(subscription_id) # Look up your user in the database using the metadata passed into # Checkout Session create user_id = subscription.metadata["my_user_id"] user = User.find_by_id(user_id) # Fill in your logic here: mark_subscription_active(user, subscription) when 'v2.billing.rate_card_subscription.servicing_paused' # The customer paused the subscription. subscription_id = event.related_object.id subscription = client.v2.billing.rate_card_subscriptions .retrieve(subscription_id) # Look up your user in the database using the metadata passed into # Checkout Session create user_id = subscription.metadata["my_user_id"] user = User.find_by_id(user_id) # Fill in your logic here: mark_subscription_paused(user, subscription) when 'v2.billing.rate_card_subscription.servicing_canceled' # The customer canceled the subscription. subscription_id = event.related_object.id subscription = client.v2.billing.rate_card_subscriptions .retrieve(subscription_id) # Look up your user in the database using the metadata passed into # Checkout Session create user_id = subscription.metadata["my_user_id"] user = User.find_by_id(user_id) # Fill in your logic here: mark_subscription_canceled(user, subscription) end status 200 end

オプション組み込みをテストする

オプション税金を徴収する

オプションカスタム期間の使用状況を取得する

このページはお役に立ちましたか。
はいいいえ
お困りのことがございましたら 、サポートにお問い合わせください。
早期アクセスプログラムにご参加ください。
変更ログをご覧ください。
ご不明な点がございましたら、お問い合わせください。
LLM ですか?llms.txt を読んでください。
Powered by Markdoc