# 請求クレジット 請求クレジットをプリペイドまたはプロモーションの使用量ベースの商品またはサービスに適用する方法をご紹介します。 クレジット付与を利用して、次のようなビジネスワークフローで顧客に請求クレジットを提供します。 - **プリペイド**： メンバーシップ、従量課金制プラン、サブスクリプション、特定のプロダクトやサービスなど、従量課金のプロダクトやサービスの支払いに使用できる請求クレジットを顧客に付与します。 - **プロモーションでの提供**: プロモーション商品として顧客に請求クレジットを無料で付与します。事業者は限られた金額のプロモーションクレジットを提供することが多く、通常は有効期限があります。 次の図は、従量課金で請求クレジットがどのように機能するかを示しています。 (See full diagram at https://docs.stripe.com/billing/subscriptions/usage-based/billing-credits) ```text [customer] -- ある (複数) --> [クレジット付与] [クレジット付与] -- 適用先 --> [請求書] [customer] -- 生成する --> [メーターイベント] [メーターイベント] -- 集計 (メーター) と評価 (価格) --> [請求書] ``` ## 請求クレジットのユースケース 請求クレジットの使用については、次のガイダンスを参照してください。 **承認されている用途** - 請求クレジットは、無料または有料で顧客に発行できます。 - 顧客は請求クレジットを使用して、会費、従量課金プラン、サブスクリプション、または貴社提供の特定の商品・サービスを支払うことができます。 **禁止されている用途** - 請求クレジットをギフトカードまたはギフト券として発行することはできません。また、顧客が請求クレジットを使って、ギフトカードやギフト券を購入したり交換したりすることはできません。 - 請求クレジットをストアドバリューとして顧客に提供することはできません。つまり、メンバーシップ、従量課金制プラン、サブスクリプション、または提供する特定の商品やサービスへの支出を対象としていない請求クレジットを付与することはできません。 - 顧客がサードパーティーへの支払いに請求クレジットを使用することは許可できません。たとえば、顧客が別の事業者のウェブサイトやプラットフォームでの購入に請求クレジットを適用できるようにすることはできません。 - 請求クレジットをデジタルウォレットに関連付けたり、顧客に関連付けることを許可したりすることはできません。たとえば、顧客が Apple Pay や Google Pay などのデジタルウォレットに請求クレジットを追加できるようにすることはできません。 ## クレジット付与 [Credit Grant](https://docs.stripe.com/api/billing/credit-grant.md) (クレジット付与) は、顧客に割り当てられた一連のプリペイドまたはプロモーションの請求クレジットを追跡します。クレジット付与には、次の状態があります。 | 都道府県 | 説明 | | --- | --- | | 保留 | クレジット付与の [available_balance](https://docs.stripe.com/api/billing/credit-balance-summary/object.md#billing_credit_balance_summary_object-balances-available_balance) はまだ使用できません。 | | 付与済み | クレジット付与は、[effective_at](https://docs.stripe.com/api/billing/credit-grant/object.md#billing_credit_grant_object-effective_at) タイムスタンプに基づいて使用できるようになります。そのタイミングは将来の日時である必要があります。このフィールドを設定しない場合、クレジット付与はすぐに有効になります。 | | 枯渇 | クレジット付与の残高がすべて使用されています。 | | 期限切れ | クレジット付与の残りのクレジットをすぐに[期限切れ](https://docs.stripe.com/api/billing/credit-grant/expire.md)にするか、[expires_at](https://docs.stripe.com/api/billing/credit-grant/object.md#billing_credit_grant_object-expires_at) フィールドを使用してクレジット付与の有効期限を指定できます。このフィールドを設定しない限り、クレジットは期限切れになりません。 | | 無効 | [無効](https://docs.stripe.com/api/billing/credit-grant/void.md)にできるのは、一部または全部を請求書に適用していないクレジット付与のみです。無効になったクレジット付与を今後の請求書に適用することはできませんが、残っているクレジットを期限切れにすることはできます。 | ## クレジット付与の対象 次のすべてに当てはまる場合は、請求書にクレジット付与を適用できます。 - 請求書の [period_end](https://docs.stripe.com/api/invoices/object.md#invoice_object-period_end) が、クレジット付与の [effective_at](https://docs.stripe.com/api/billing/credit-grant/object.md#billing_credit_grant_object-effective_at) の時刻以降である。 - 請求書の `period_end` が、クレジット付与の [expires_at](https://docs.stripe.com/api/billing/credit-grant/object.md#billing_credit_grant_object-expires_at) の時刻 (設定されている場合) より前に発生する。 - 請求書の確定時にクレジット付与に利用可能な残高がある。 - クレジット付与の通貨が請求書の通貨と一致している。 クレジット付与は、[従量制](https://docs.stripe.com/api/prices/object.md#price_object-recurring-usage_type)料金を採用し、[Meter (メーター)](https://docs.stripe.com/api/billing/meter.md) の使用量を報告しているサブスクリプションアイテムにのみ適用できます。 クレジット付与は、以下には適用できません。 - サブスクリプションによって作成されていない 1 回限りの請求書。 - サブスクリプションの[請求書のプレビュー](https://docs.stripe.com/api/invoices/create_preview.md)に追加される 1 回限りの請求書のラインアイテム (例: 初期設定手数料)。 - [ライセンス](https://docs.stripe.com/api/prices/object.md#price_object-recurring-usage_type)料金を採用しているサブスクリプションの請求書の[ラインアイテム](https://docs.stripe.com/api/invoices/object.md#invoice_object-lines)。 - [従量制](https://docs.stripe.com/api/prices/object.md#price_object-recurring-usage_type)料金を採用し、レガシーの[使用状況記録](https://docs.stripe.com/api/usage_records.md)の使用量を報告しているサブスクリプションの請求書の[ラインアイテム](https://docs.stripe.com/api/invoices/object.md#invoice_object-lines)。 ## クレジット付与を適用する クレジット付与は、[メーター価格](https://docs.stripe.com/api/billing/credit-grant/object.md?api-version=2025-09-30.preview&rds=1#billing_credit_grant_object-applicability_config-scope) に紐づいた [サブスクリプションアイテム](https://docs.stripe.com/api/subscription_items.md) に適用できます。クレジット付与は、割引の後に、ただし税金と [invoice_credit_balance](https://docs.stripe.com/api/customers/object.md#customer_object-invoice_credit_balance) の前に、請求書に適用されます。 ### 価格レベルの適用性 クレジット付与を作成するときに、[適用範囲](https://docs.stripe.com/api/billing/credit-grant/create.md#create_billing_credit_grant-applicability_config-scope-price_type)を構成して、クレジット付与を適用できる従量制料金の一覧を指定できます。サブスクリプションアイテムの料金が、クレジット付与の適用価格のいずれかと一致する場合、クレジット付与はそのアイテムに適用されます。 ### 複数の請求書またはラインアイテム クレジット付与を複数の請求書に適用できる場合、クレジットは最初に確定された請求書から順番に適用されます。サブスクリプションの請求書は、対象になるとすぐに個別に確定されるため、確定順序を保証することはできません。 同じ請求書の複数の [Line](https://docs.stripe.com/api/invoices/object.md#invoice_object-lines) (ラインアイテム) にクレジット付与を適用できる場合、クレジットは請求書に記載されている順序でラインアイテムに適用されます。 ### 複数のクレジット付与 1 つの請求書またはラインアイテムに複数のクレジット付与を適用できる場合は、次のように優先順位が付けられます。 1. **優先度**: [優先度](https://docs.stripe.com/api/billing/credit-grant/object.md#billing_credit_grant_object-priority)の高いクレジット付与 (数値が小さいほど優先度が高いことを表します) が最初に適用されます。 2. **有効期限**：[expires_at](https://docs.stripe.com/api/billing/credit-grant/object.md#billing_credit_grant_object-expires_at) タイムスタンプが早いクレジット付与が先に適用されます。 3. **カテゴリ**：`promotional` カテゴリのクレジット付与が先に適用されます。 4. **発効日**:[effective_at](https://docs.stripe.com/api/billing/credit-grant/object.md#billing_credit_grant_object-effective_at) タイムスタンプが早いクレジット付与が先に適用されます。 5. **作成日**:[created](https://docs.stripe.com/api/billing/credit-grant/object.md#billing_credit_grant_object-created) タイムスタンプが早いクレジット付与が先に適用されます。 ### 請求書のプレビュー、下書き、確定 クレジットが請求書に適用されるのは、[確定](https://docs.stripe.com/invoicing/integration/workflow-transitions.md#finalized)の時点のみです。[プレビュー](https://docs.stripe.com/api/invoices/create_preview.md)または[下書き](https://docs.stripe.com/invoicing/overview.md#draft)の請求書にクレジットを適用する場合、確定した請求書でクレジットが先に使用されると、クレジットが変更される可能性があります。 **例 1**: サイクルの終了時に、請求書の下書きと請求書のプレビューの両方に同じクレジットのセットが表示されます。確定されると、請求書の下書きでクレジットが使用されます。請求書のプレビューは、クレジット付与の残りのクレジットを正確に反映するように調整されます。 **例 2**: 顧客には複数の有効なサブスクリプションがあり、すべてのサブスクリプションについて、請求書のプレビューに同じクレジットのセットが表示されます。請求書の確定時にすべてのサブスクリプションに適用する十分なクレジットがない場合、一部の請求書にしかクレジットが適用されません。[請求しきい値](https://docs.stripe.com/billing/subscriptions/usage-based/thresholds.md)を使用すると、複数の請求書のプレビューにクレジットが適用されるため、トリガーが想定よりも遅くなる可能性があります。 ## クレジット残高のサマリーと取引 [Credit Balance Summary](https://docs.stripe.com/api/billing/credit-balance-summary.md) (クレジット残高サマリー) には、顧客に関する次の情報が表示されます。 - **元帳残高**:残高金額には、関連するすべての勘定元帳取引を記録した後の請求クレジット残高が反映されます。クレジット付与は、追加専用で変更不可の台帳によって裏付けられています。 - **利用可能な残高**:顧客が使用できる請求クレジット残高。この金額は、元帳残高から期限切れのクレジットまたは未記録の取引を差し引いた金額に等しくなります。 [Credit Balance Transaction](https://docs.stripe.com/api/billing/credit-balance-transaction.md) (クレジット取引残高) には、クレジット付与に影響するクレジットとデビットが含まれます。たとえば、クレジット付与の初期資金調達のクレジット取引や、クレジット付与のデビット取引が請求書に表示されることがあります。 ## 請求書の無効化とクレジットノートの発行 請求書を無効化してクレジットノートを発行する場合は、次のようになります。 - クレジットが適用された[請求書を無効にする](https://docs.stripe.com/api/invoices/void.md)と、適用された残高がクレジット付与に戻されます。クレジット付与が有効期限を過ぎている場合、戻されたクレジットはすぐに期限切れになります。 - [クレジットノート](https://docs.stripe.com/api/credit_notes/object.md)を発行しても、請求書に適用されたクレジット付与は返金されません。このような請求クレジットを元に戻すには、新しいクレジット付与を作成する必要があります。 ## 未使用のクレジット付与に関する制限事項 顧客は、一度に最大 100 件の未使用のクレジット付与を保有できます。この制限を超えてクレジット付与を発行すると、リクエストは失敗し、最大制限を示すエラーメッセージが表示されます。 ### クレジット付与が未使用の場合 以下のすべてに該当する場合、クレジット付与は未使用です: - クレジット付与が無効化されていない。 - クレジット付与が [expires_at](https://docs.stripe.com/api/billing/credit-grant/object.md#billing_credit_grant_object-expires_at) の期限を過ぎていない。 - クレジット付与は保留中 ([effective_at](https://docs.stripe.com/api/billing/credit-grant/object.md#billing_credit_grant_object-effective_at) 以前) であるか、[元帳残高](https://docs.stripe.com/api/billing/credit-balance-summary/object.md#billing_credit_balance_summary_object-balances-ledger_balance)がプラスです。 ### クレジット付与が未使用でなくなった場合 以下のいずれかが発生した場合、クレジット付与は限度額にカウントされなくなります: | イベント | 説明 | | --- | --- | | 枯渇 | クレジット付与の元帳残高は、確定請求書にクレジットを適用した後でゼロになります。 | | 期限切れ | クレジット付与が `expires_at` の期限に到達するか、[Expire](https://docs.stripe.com/api/billing/credit-grant/expire.md) エンドポイントを使用して期限切れにする。 | | 無効 | [Void](https://docs.stripe.com/api/billing/credit-grant/void.md) エンドポイントを使用してクレジット付与を無効にする。 | ### 利用可能な残高と元帳残高 未使用のクレジット付与限度額は、[利用可能残高](https://docs.stripe.com/api/billing/credit-balance-summary/object.md#billing_credit_balance_summary_object-balances-available_balance) ではなく [元帳残高](https://docs.stripe.com/api/billing/credit-balance-summary/object.md#billing_credit_balance_summary_object-balances-ledger_balance) が基準となります。クレジットは確定時の請求書にのみ適用されます。たとえば、利用可能残高がゼロで元帳残高がプラスのクレジット付与でも、限度額にカウントされます。 クレジット付与のクレジットが下書き請求書に表示される場合、利用可能な残高はゼロと表示される場合がありますが、請求書が確定されるまで元帳残高はプラスのままです。この場合、クレジット付与は引き続き未使用限度額にカウントされます。