アラートとしきい値ベータ
顧客が使用量のしきい値を超えた場合に、にアラートを送信します。または、顧客が請求しきい値に達した場合に、請求書をトリガーします。
使用量のアラート
計測された使用量に対して使用量のアラートを設定できます。顧客が特定の使用量レベルに達したときに Webhook をトリガーするアラートを設定できます。特定の顧客またはすべての顧客にアラートを適用します。使用状況に関するアラートのタイプ:
- 1 回限りの顧客ごとの使用量アラート: 顧客が指定された使用量レベルを初めて超えたときにトリガーされます。たとえば、顧客が 100 件の API コールに達したときに、その顧客向けに 1 回限りのアラートを作成します。いずれかの顧客が 100 件の AP I コールに達すると、その顧客がしきい値を超えたことを通知する Webhook を受け取ります。このアラートは、今後の使用に関係なく、顧客ごとに 1 回のみトリガーされます。
使用量のアラートは、次のようなビジネスワークフローで使用できます。
- メールユーザー: ユーザーが使用量の上限を設定し、上限に達したときにメールを送信することを許可します。
- アクセス提供を制限: ユーザーにサービスへの使用ユニット数を無料で提供し、上限を超えた場合にアクセス権を削除します。
- 営業チームにアップセルを通知: セルフサービスのユーザーが使用量のしきい値を超えた場合、企業の販売機会について営業チームに通知します。
ダッシュボードまたは API を使用してアラートを作成できます。
アラートを設定し、その基準の使用量の送信を開始したら、Webhook をリッスン を実行する必要があります。
制限事項
- アラートはアラート作成時に評価されず、アラート作成後に報告された使用量データによってのみ評価されます。
- 各範囲 (従量課金と顧客フィルターの組み合わせ) のアラートは、25 件に制限されています。たとえば、特定の従量課金と顧客に対して 25 件を超えるアラートを作成することはできません。ただし、各顧客に特定の従量のアラートを作成できます。
- 現在、アラートはテストクロックでは機能しません。
支出とクレジットのアラート
顧客の支出が一定額を超えた場合、または利用可能なクレジットが少なくなった場合に、アラートを指定できます。顧客がこれらのしきい値に達すると、アラートによって Webhook がトリガーされます。ベータ版への参加をご希望の場合は、こちらをクリックをクリックします。
請求しきい値
請求しきい値を作成して、サブスクリプションサイクルで顧客の未払いの使用量が特定の金額のしきい値に達した際に請求書を発行し、必要に応じてサブスクリプションの請求サイクルの起点をリセットします。請求書と次回の請求書または支払いと次回の支払いの間の未払い金額や商品消費を制限する予防措置を追加するには、請求しきい値の使用を検討してください。
サブスクリプションに金額のしきい値を追加する
しきい値は、販売商品の単価の倍数に設定するのが一般的です。
金額しきい値を低く設定すると、顧客は使用量の単位ごとに請求書を受け取ることになり混乱を招くおそれがあります。
この値は、最小通貨単位による正の整数です (1 USD を請求する場合は 100 セント、小数点以下のない通貨の 100 JPY を請求する場合は 100)。値は 50 通貨単位以上に設定します。
サブスクリプションを作成または更新する際に、ダッシュボードで金額のしきい値を設定することもできます。
サブスクリプションアイテムに使用量のしきい値を追加する
請求書の作成頻度を抑えるため、使用量のしきい値には使用量の 1 ユニットよりも大きい値を設定します。Stripe では、ダッシュボードで使用量のしきい値を設定することはできません。
しきい値と請求サイクルの起点
デフォルトでは、顧客の使用量がしきい値に達した後も、サブスクリプションの請求サイクルの起点は変わりません。たとえば、1 カ月間のサブスクリプションの途中でしきい値に達した場合には、しきい値のないサブスクリプションと同様にその月の最後にリセットされます。
しきい値に達すると請求サイクルの起点がリセットされるようにサブスクリプションを設定することで、この動作を変更できます。Stripe では、しきい値への到達を、サブスクリプションが自然に月末のロールオーバーポイントに到達したものと同様に扱います。
しきい値と段階制料金
Stripe は、しきい値のある請求書全体で段階を管理します。しきい値のないサブスクリプションと同様に、段階は請求期間の終了時にデフォルトでリセットされますが、しきい値に達した後に請求サイクルの起点をリセットするようにサブスクリプションを設定することもできます。
広告インプレッションに対して以下の graduated
段階構造が設定された、広告プラットフォームを運営しているとします。
段階 | 金額 (単価) |
---|---|
1 ~ 10000 (up_ ) | 0.50 USD (unit_ ) |
10000+ (up_ ) | 0.40 USD (unit_ ) |
Stripe は使用量をさかのぼって請求するため、新しい顧客に対するしきい値は一時的な措置として 100 USD に設定できます。このプランでは、最初の 1 万回のインプレッションまでは 200 インプレッションごとに顧客に請求します (200 x 0.50 USD = 100 USD)。顧客のインプレッションが 1 万回を超えると、250 インプレッションごとに顧客に請求します (250 x 0.40 USD = 100 USD)。これが請求期間の最後まで続き、この最後の時点ですべての未請求の使用量が請求され、サブスクリプションと段階がリセットされます。
しきい値に達したときに段階をリセットするには、サブスクリプションの設定で使用量が設定したしきい値に達した後に請求サイクルの起点がリセットされるようにする必要があります。
数量ベースの段階
数量ベースの段階は、特定の使用量の料金を定義する段階的な階層とは異なり、すべての使用量ユニットの料金を定義します。一部の料金体系モデルでは、段階が上がるたびに単価が下がる数量ベースの段階を使用しています。このようなモデルを使用することで、顧客の使用量の増加を促すことができます (例: 広告インプレッション、ストレージのギガバイト数など)。
これをしきい値と組み合わせた場合、この料金体系モデルでは以下の状況でマイナス金額のラインアイテムを含む請求書が生成されることがあります。
- しきい値のある請求書がすでに発行されています。
- その後の使用量は低い単価で請求されます。
たとえば、以下の段階制料金構造について考えてみます。
段階 | 金額 (単価) |
---|---|
1 ~ 10000 (up_ ) | 0.50 USD (unit_ ) |
10000+ (up_ ) | 0.40 USD (unit_ ) |
顧客が 10,000 ユニットを使用すると、請求書の合計は 5,000 USD (10,000 x 0.50 USD = 5,000 USD) になります。その後さらに使用を続けることで、「すべて」の使用量が、低い単価である 0.40 USD で請求されます。このため、顧客がもう 1 ユニット使用すると、請求書は 4,000.40 USD に「減少」します (10,001 x 0.40 USD = 4,000.40 USD)。
しきい値を指定しない場合、Stripe は請求期間の最後に 4,000.40 USD の請求書を発行することになります。
5,000 USD の金額しきい値が存在する場合に、どのようにしてマイナスの請求が発生するのかを確認してみましょう。このシナリオでは、顧客の使用量が 10,000 ユニットに達すると Stripe が請求書を発行します。
顧客がもう 1 ユニット使用すると、請求書の合計は 4,000.40 USD (10,001 x 0.40 USD = 4,000.40 USD) に減少します。ただし、顧客がそれ以上 1 ユニットも使用しなければ、999.60 USD の「超過支払い額」が生じます (5,000 USD - 4,000.40 USD = 999.60 USD)。請求期間の最後に、Stripe はこの金額を顧客の残高に加え、将来の請求書の支払いに充当します。
顧客が使用を続けたと仮定します。この使用量のコストは、顧客が 12,500 ユニットを使用すると、再び 5,000 USD に達します (5,000 USD ÷ 0.40 USD = 12,500)。ただし、前回の支払いである 5,000 USD がこの使用量に充当されるため、Stripe は請求書を発行しません。
Stripe は、合計使用量が 25,000 ユニット (合計費用が 10,000 USD) に達するか、請求期間の終了まで (どちらか早く発生した方)、請求書を発行しません。以下の表は、使用量が 25,000 ユニットに達した場合に発行される 2 種類の請求書に表示されるラインアイテムを示しています。
請求書 1:
ラインアイテム | 数量 | 金額 |
---|---|---|
使用量 (単価 0.50 USD) | 10,000 | 5,000 USD |
合計 | 5,000 USD |
請求書 2:
ラインアイテム | 数量 | 金額 |
---|---|---|
使用量 (単価 0.40 USD) | 25,000 | 10,000 USD |
前回請求された金額 (単価 0.50 USD) | -5,000 USD | |
合計 | 5,000 USD |
制限事項
- しきい値は、トライアルのサブスクリプションには適用されません。
- 金額のしきい値は、従量課金のサブスクリプションアイテムの定額手数料の合計費用以上にする必要があります。
- サブスクリプションの終了までの 24 時間は、Billing しきい値が評価されません。これは、同じ日に複数の請求書を受け取った顧客の混乱を防ぐのに役立ちます。
- サブスクリプションに設定できる金額のしきい値は 1 つのみです。
- サブスクリプションアイテムに設定できる使用量のしきい値は 1 つのみです。
- 使用量の報告はリアルタイムで行われるため、指定されたしきい値に達した瞬間に請求書が発行されるとは限りません。請求金額または使用量が指定のしきい値よりも若干高くなる場合があります。
- 金額のしきい値に達したかどうかの判断に使用される金額に税金は含まれませんが、割引は含まれます。
- パッケージごとの段階制料金は現在サポートされていません
Webhook をリッスンする
導入を完了するには、Stripeから送信される Webhook を処理する必要があります。これらのイベントは、新しいサブスクリプションや請求書が作成されるなど、Stripe 内の状態が変化するたびにトリガーされます。アプリケーションで、Webhook イベントを含む POST リクエストを受け取る HTTP ハンドラを設定し、イベントの署名を検証します。
開発中は、Stripe CLI を使用して Webhook をモニタリングし、アプリケーションに転送します。開発アプリの実行中に、新しい端末で以下を実行します。
stripe listen --forward-to localhost:4242/webhook
本番環境では、ダッシュボードで Webhook エンドポイント URL を設定するか、Webhook Endpoints API を使用します。