請求クレジット公開プレビュー

請求クレジットをプリペイドまたはプロモーションの使用量ベースの商品またはサービスに適用する方法をご紹介します。

クレジット付与を利用して、次のようなビジネスワークフローで顧客に請求クレジットを提供します。

プリペイド：メンバーシップ、従量課金制プラン、サブスクリプション、特定のプロダクトやサービスなど、従量課金のプロダクトやサービスの支払いに使用できる請求クレジットを顧客に付与します。
プロモーションでの提供: プロモーション商品として顧客に請求クレジットを無料で付与します。事業者は限られた金額のプロモーションクレジットを提供することが多く、通常は有効期限があります。

次の図は、従量課金で請求クレジットがどのように機能するかを示しています。

請求クレジットのユースケース

請求クレジットの使用については、次のガイダンスを参照してください。

承認されている用途

請求クレジットは、無料または有料で顧客に発行できます。
顧客は請求クレジットを使用して、会費、従量課金プラン、サブスクリプション、または貴社提供の特定の商品・サービスを支払うことができます。

禁止されている用途

請求クレジットをギフトカードまたはギフト券として発行することはできません。また、顧客が請求クレジットを使って、ギフトカードやギフト券を購入したり交換したりすることはできません。
請求クレジットをストアドバリューとして顧客に提供することはできません。つまり、メンバーシップ、従量課金制プラン、サブスクリプション、または提供する特定の商品やサービスへの支出を対象としていない請求クレジットを付与することはできません。
顧客がサードパーティーへの支払いに請求クレジットを使用することは許可できません。たとえば、顧客が別の事業者のウェブサイトやプラットフォームでの購入に請求クレジットを適用できるようにすることはできません。
請求クレジットをデジタルウォレットに関連付けたり、顧客に関連付けることを許可したりすることはできません。たとえば、顧客が Apple Pay や Google Pay などのデジタルウォレットに請求クレジットを追加できるようにすることはできません。

クレジット付与

Credit Grant (クレジット付与) は、顧客に割り当てられた一連のプリペイドまたはプロモーションの請求クレジットを追跡します。クレジット付与には、次の状態があります。

都道府県	説明
保留	クレジット付与の available_balance はまだ使用できません。
付与済み	クレジット付与は、effective_at タイムスタンプに基づいて使用できるようになります。そのタイミングは将来の日時である必要があります。このフィールドを設定しない場合、クレジット付与はすぐに有効になります。
枯渇	クレジット付与の残高がすべて使用されています。
期限切れ	クレジット付与の残りのクレジットをすぐに期限切れにするか、expires_at フィールドを使用してクレジット付与の有効期限を指定できます。このフィールドを設定しない限り、クレジットは期限切れになりません。
無効	無効にできるのは、一部または全部を請求書に適用していないクレジット付与のみです。無効になったクレジット付与を今後の請求書に適用することはできませんが、残っているクレジットを期限切れにすることはできます。

クレジット付与の対象

次のすべてに当てはまる場合は、請求書にクレジット付与を適用できます。

請求書の period_end が、クレジット付与の effective_at の時刻以降である。
請求書の period_end が、クレジット付与の expires_at の時刻 (設定されている場合) より前に発生する。
請求書の確定時にクレジット付与に利用可能な残高がある。
クレジット付与の通貨が請求書の通貨と一致している。

クレジット付与は、従量制料金を採用し、Meter (メーター) の使用量を報告しているサブスクリプションアイテムにのみ適用できます。

クレジット付与は、以下には適用できません。

サブスクリプションによって作成されていない 1 回限りの請求書。
サブスクリプションの請求書のプレビューに追加される 1 回限りの請求書のラインアイテム (例: 初期設定手数料)。
ライセンス料金を採用しているサブスクリプションの請求書のラインアイテム。
従量制料金を採用し、レガシーの使用状況記録の使用量を報告しているサブスクリプションの請求書のラインアイテム。

クレジット付与を適用する

クレジット付与は、メーターの価格にリンクされているサブスクリプションに適用できます。クレジット付与は、割引後、税金と invoice_credit_balance を差し引く前の請求書に適用されます。

価格レベルの適用性

クレジット付与を作成するときに、適用範囲を構成して、クレジット付与を適用できる従量制料金の一覧を指定できます。サブスクリプションアイテムの料金が、クレジット付与の適用価格のいずれかと一致する場合、クレジット付与はそのアイテムに適用されます。

複数の請求書またはラインアイテム

クレジット付与を複数の請求書に適用できる場合、クレジットは最初に確定された請求書から順番に適用されます。サブスクリプションの請求書は、対象になるとすぐに個別に確定されるため、確定順序を保証することはできません。

同じ請求書の複数の Line (ラインアイテム) にクレジット付与を適用できる場合、クレジットは請求書に記載されている順序でラインアイテムに適用されます。

複数のクレジット付与

1 つの請求書またはラインアイテムに複数のクレジット付与を適用できる場合は、次のように優先順位が付けられます。

優先度: 優先度の高いクレジット付与 (数値が小さいほど優先度が高いことを表します) が最初に適用されます。
有効期限：expires_at タイムスタンプが早いクレジット付与が先に適用されます。
カテゴリ：promotional カテゴリのクレジット付与が先に適用されます。
発効日:effective_at タイムスタンプが早いクレジット付与が先に適用されます。
作成日:created タイムスタンプが早いクレジット付与が先に適用されます。

請求書のプレビュー、下書き、確定

クレジットが請求書に適用されるのは、確定の時点のみです。プレビューまたは下書きの請求書にクレジットを適用する場合、確定した請求書でクレジットが先に使用されると、クレジットが変更される可能性があります。

例 1: サイクルの終了時に、請求書の下書きと請求書のプレビューの両方に同じクレジットのセットが表示されます。確定されると、請求書の下書きでクレジットが使用されます。請求書のプレビューは、クレジット付与の残りのクレジットを正確に反映するように調整されます。

クレジット残高のサマリーと取引

Credit Balance Summary (クレジット残高サマリー) には、顧客に関する次の情報が表示されます。

元帳残高:残高金額には、関連するすべての勘定元帳取引を記録した後の請求クレジット残高が反映されます。クレジット付与は、追加専用で変更不可の台帳によって裏付けられています。
利用可能な残高:顧客が使用できる請求クレジット残高。この金額は、元帳残高から期限切れのクレジットまたは未記録の取引を差し引いた金額に等しくなります。

Credit Balance Transaction (クレジット取引残高) には、クレジット付与に影響するクレジットとデビットが含まれます。たとえば、クレジット付与の初期資金調達のクレジット取引や、クレジット付与のデビット取引が請求書に表示されることがあります。

請求書の無効化とクレジットノートの発行

請求書を無効化してクレジットノートを発行する場合は、次のようになります。

クレジットが適用された請求書を無効にすると、適用された残高がクレジット付与に戻されます。クレジット付与が有効期限を過ぎている場合、戻されたクレジットはすぐに期限切れになります。
クレジットノートを発行しても、請求書に適用されたクレジット付与は返金されません。このような請求クレジットを元に戻すには、新しいクレジット付与を作成する必要があります。

未使用のクレジット付与に関する制限事項

顧客は、未使用のクレジット付与を一度に最大 20 件まで受けることができます。この制限を超えてクレジット付与を発行すると、リクエストは失敗し、最大上限を示すエラーメッセージが表示されます。クレジット付与は、将来の発効日またはプラスの残高である場合、未使用として処理されます。