請求クレジット公開プレビュー
請求クレジットは、プリペイドまたはプロモーションの従量課金ベースのプロダクトやサービスに対する請求に使用します。
次のようなビジネスワークフローで、クレジット付与を使用して顧客にクレジットを提供できます。
- Prepayment: Grant billing credits at the exchange of prepayment from your customer for usage-based products or services.
- Prepaid models can bring immediate cash flow, establish more predictable revenue, and support liquidity and financial steadiness.
- プロモーション提供: プロモーション提供として、請求クレジットを無料でユーザーに付与します。多くの場合、限られた金額のプロモーションクレジットを提供します (通常は有効期限が設定されます)。
請求クレジットの仕組み
クレジット付与 | クレジット付与は、特定の顧客のプリペイド (またはプロモーション) クレジットを追跡します。 |
クレジット取引残高 | Credit balance transactions are an auditable history of changes and actions that impact a particular credit grant. These transactions can either be credits or debits. Some examples:
|
クレジット取引サマリー | クレジット残高のサマリーには、顧客の現在の元帳と利用可能な残高が表示されます。
|
この図は、従量課金の概念の下での請求クレジットの仕組みを示しています。
クレジットのライフサイクル
クレジット付与は、付与保留中 (effective_at の前)、付与済みで利用可能、消費済み (残高を全額使用済み)、期限切れ (expires_at 以降)、無効化済みなどの複数の状態のいずれかになります。
付与
各クレジット付与には、利用できるようになった時点を示す effective_at タイムスタンプがあります。このフィールドを明示的に指定しない場合、クレジット付与はデフォルトですぐに有効になります。effective_
を未来のタイムスタンプに設定することもできます。この場合、指定された発効日までクレジット付与の利用可能な残高はゼロになります。発効時に、クレジットが付与され、それに応じて利用可能な残高が調整されます。effective_
には過去の時間を指定できず、既存のクレジット付与のフィールドを更新することもできません。
有効期限
オプションで、クレジット付与に対して将来の expires_at フィールドを指定できます。期限切れ時に、クレジット付与に利用可能な残高がゼロになります。このフィールドを設定しない場合、クレジットは期限切れになりません。また、ダッシュボードまたは API を使用して、クレジット付与の残りのクレジットをすぐに期限切れにできます。
無効
請求書に適用されていないクレジット付与はすべて無効化できます。無効になったクレジット付与は、その後の請求書に適用されません。請求書に適用されたクレジット付与は、一部も全体も無効にできません。ただし、残りのクレジットは期限切れにできます。
請求書へのクレジット適用
When integrating with billing credits, you must consider the eligibility criteria and nuances associated with credit applications on different types of invoices.
クレジット付与の対象
クレジット付与は、請求メーターの金額に関連付けられているサブスクリプションの請求書のラインアイテムに適用できます。クレジット付与は次のものには適用されません
- サブスクリプション以外の請求書 (1 回限りの請求書など)
- ライセンス料金に関連付けられているサブスクリプションの請求書のラインアイテム
- レガシーの Usage Records API を使用して価格に関連付けられているサブスクリプションの請求書のラインアイテム
請求書が生成された時点の請求書の period_end を使用して、クレジット付与が請求書への適用対象であるかどうかを判断します。次のすべてに該当する場合、クレジット付与は請求書への適用対象になります。
- 請求書の
period_
が、クレジット付与の effective_at の時刻以降であること。end - クレジット付与に expires_at が設定されていないこと。設定されている場合は、請求書の
period_
が、クレジット付与のend expires_
の時点より前であること。at - クレジット付与に、請求書の確定時点でプラスの利用可能な残高があること。
- クレジット付与の通貨が請求書の通貨と一致していること。クレジット付与は、顧客のデフォルトの通貨でのみ発行できます。
請求書は、対象になるクレジット付与から適用可能なクレジットを使用します。クレジット付与は、割引の後、税金と請求書のクレジット残高の前に、請求書に適用されます。
複数の請求書とラインアイテムへのクレジット付与の適用
クレジット付与が複数の請求書に適用される場合、先に確定された請求書が先にクレジットを消費します。サブスクリプションの請求書の確定順序について、厳密な保証はありません。請求書は、対象になるとすぐに独立して確定されます。同様に、クレジット付与が同じ請求書の複数のラインアイテムに適用される場合、ラインアイテムがクレジットを消費する順序は保証されません。通常、ラインアイテムは、請求書に記載された順序でクレジットを 1 つずつ消費します。
近日中、下書き、および確定済みの各請求書へのクレジット
クレジットは、確定時点ではじめて請求書によって使用されます。近日中の請求書と下書きの請求書に表示されるクレジットの適用は、時間の経過に伴って変更されることがあります。たとえば、確定済みの請求書が、近日中の請求書に表示されているクレジットを数分後に使用する場合があります。
サイクルの終了時に、有効な時期と期限切れになる時期に基づくとクレジットが両方の対象になると推定されて、同じクレジットのセットが、下書きの請求書と次のサイクルの近日中の請求書の両方に表示される場合があります。確定されると、下書きの請求書にクレジットが使用されます。次に、近日中の請求書が、クレジット付与の残りのクレジットを正確に反映するように調整されます。
If a customer has multiple active subscriptions, the same set of credits might appear on the upcoming invoices for all of them. If the credits are insufficient to cover all the subscriptions when finalized invoices are generated, then only some invoices might use the credits. If you also use billing thresholds, the thresholds might trigger later than expected due to credits that apply to multiple upcoming subscription invoices.
クレジット付与の優先順位
請求書のラインアイテムに適用する対象になるクレジット付与が複数ある場合は、次のように優先順位が付けられます。
- 有効期限日: expires_at タイムスタンプが早いクレジット付与が先に使用されます。
- カテゴリー:
promotional
カテゴリーのクレジット付与が先に使用されます。 - 発効日: effective_at タイムスタンプが早いクレジット付与が先に使用されます。
- 作成日: created タイムスタンプが早いクレジット付与が先に使用されます。
請求書を無効にしてクレジットノートを発行する
The following limitations apply to voiding invoices and issuing credit notes:
- Voiding an invoice that has credits applied doesn’t reinstate the applied balance to the credit grant.
- Issuing credit notes doesn’t refund credit grants applied to an invoice. To restore those billing credits, create a new credit grant.
請求クレジットのユースケース
承認された使用法
- 特定の商品またはサービスを販売する
- プロダクト/サービスのメンバーシップを提供する
制限された使用法
以下の目的には使用しないでください。
- ギフトカードを販売する
- プリペイド型電子マネーを顧客に提供する
- ウォレット機能を提供する
- サードパーティーの商品またはサービスを購入できるようにする
お客様の責任事項
- 法律および規制で定められた義務を遵守する (本人認証など)
- 取引規約について顧客の同意を得る
- カードネットワークのルールに従う (Visa など)
Stripe のポリシーとベストプラクティスの詳細については、ウェブサイトチェックリストをご覧ください。適用されるすべての規制を遵守するために、この機能を使用する前に法律顧問に相談することをお勧めします。