# 顧客請求書残高 顧客請求書残高の使用方法をご確認ください。 Stripe Billing のすべての顧客には、お客様がクレジットとデビットの調整を発行できる請求書残高があります。請求書残高の調整は、クレジット (お客様が顧客に支払うべき金額) またはデビット (顧客がお客様に支払うべき金額) となります。これらの調整では、顧客の今後の*請求書* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice)に適用可能な残高が合計されます。 請求書残高は元帳 (デビット取引とクレジット取引の不変のリスト) から計算されるため、顧客に関する取引の監査証跡を提供します。お客様自身が確認できるように、これらの [Customer Balance Transactions](https://docs.stripe.com/api/customer_balance_transactions/object.md) は、調整に関連するオブジェクト ([クレジットノート](https://docs.stripe.com/invoicing/dashboard/credit-notes.md)や[顧客](https://docs.stripe.com/invoicing/customer.md))、または [メタデータ](https://docs.stripe.com/api/metadata.md)を参照します。 ## ユースケースの例 顧客の請求書残高の一般的な使用例を以下に示します。 - 次回の請求書の請求額を減らすクレジットを作成するために、[クレジットノートを発行](https://docs.stripe.com/invoicing/dashboard/credit-notes.md)します。 - [サブスクリプションのダウングレード](https://docs.stripe.com/billing/subscriptions/change-price.md)に伴う比例配分によって、間接的にクレジットを作成し、次回の請求書の請求金額を減らすことができます。 - インボイスの請求金額が[最小請求金額](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts)より少ない場合、インボイスは支払い済みとしてマークされ、未払い額はデビットとして請求書残高に移動されます。この機能は、[cash_balance](https://docs.stripe.com/billing/customer/balance.md#cash-balances) のない顧客のみが対象です。 ## 顧客の請求書残高の詳細 顧客の請求書残高を使用する場合は、以下の詳細に注意してください。 - 請求書残高は、顧客の次回の確定済みインボイスに自動的に適用されます。 - 請求書残高を適用するインボイスを選択することはできません。 - 請求書残高をインボイスに適用しないようにすることはできません。 - 請求書の残高は顧客の通貨で表示されます。 - [cash balance (現金残高)](https://docs.stripe.com/api/customers/object.md#customer_object-cash_balance) が設定された顧客は、プラス残高を維持できません。言い換えると、顧客は次の請求書の請求額を増やすことができません。 - 請求書残高は、[`invoice_creation`](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-invoice_creation) が有効になっている Checkout セッションで作成された請求書には適用されません。 - 以前作成した未払い請求書に請求書残高を適用することはできません。ただし[未払い請求書の編集](https://docs.stripe.com/invoicing/invoice-edits.md)では、請求書残高が請求書の修正に適用されます。 ## デビットとクレジット **マイナスの値** は、次回の請求書に適用できる *クレジット* (顧客が支払うべき金額の減額) として扱われます。 **プラスの値** は、次回の請求書に適用できる *デビット* (顧客がお客様に支払うべき金額の増額) として扱われます。 ## 取引 請求書残高に対するすべての変更は、[取引](https://docs.stripe.com/api/customer_balance_transactions/object.md)として記録されます。作成後は、`description` または `metadata` のみを更新できます。他のプロパティを編集したり、トランザクションを削除したりすることはできません。 ### 取引の取り消し 対応する差戻し取引を作成することによってのみ取引を取り消すことができます。たとえば、顧客に 10 USD のクレジットを適用する場合、新規取引で顧客に 10 USD のデビットを適用して、互いに相殺する必要があります。 ### 取引タイプ API またはダッシュボードで作成された[取引](https://docs.stripe.com/api/customer_balance_transactions/object.md)のすべてに [type](https://docs.stripe.com/api/customer_balance_transactions/object.md#customer_balance_transaction_object-type) 値の `adjustment` が設定されており、お客様が顧客に対して手動で作成したデビットまたはクレジットが表示されます。 `type` プロパティには、作成元や取引の理由を表すさまざまな値を指定できます。以下の表では、`type` の各値について説明します。 | タイプ | 説明 | | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `adjustment` | 請求書残高をデビットまたはクレジットするために明示的に作成された調整取引。これは、API の組み込みとダッシュボードを使用して作成できる唯一の取引タイプです。 | | `applied_to_invoice` | 関連付けられた[請求書](https://docs.stripe.com/invoicing/overview.md)に対するクレジットの適用を追跡します。 | | `credit_note` | [クレジットノート](https://docs.stripe.com/invoicing/dashboard/credit-notes.md)および関連する[請求書](https://docs.stripe.com/invoicing/overview.md)へのクレジットの作成を追跡します。 | | `invoice_too_small` | 請求書の請求金額が[最小請求可能額](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts)よりも少なく、顧客に現金残高がない場合、請求書を請求書残高に借方記入し、次回の請求書の請求金額に加算します。 | | `invoice_too_large` | 請求書の請求金額が[最大請求可能額](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts)を超え、顧客に現金残高がない場合、請求書を請求書残高に借方記入し、次回の請求書の請求金額に加算します。 | | `unapplied_from_invoice` | リンクされた [Invoice](https://docs.stripe.com/invoicing.md) から適用された請求書残高の取消を追跡します。以前の `applied_to_invoice` 取引とペアになっています。 | | `unspent_receiver_credit` | 現金残高のない顧客に関連付けられた[受取人ソース](https://docs.stripe.com/sources.md#flow-for-customer-action)の未使用の売上が 60 日後に完全に支払われていない場合、Stripe はお客様の代わりに自動的にその金額を請求し、お客様の残高に貸方記入します。これが発生した場合、Stripe は対応するクレジット取引も作成します。 | | `initial` | API を使用して請求書残高がゼロ以外の顧客を作成する場合の、顧客の請求書残高の初期値を表します。 | ## 請求書の残高を修正 ダッシュボードで顧客の請求書残高を変更するには、顧客の詳細ページから新しい [Customer Balance Transaction](https://docs.stripe.com/api/customer_balance_transactions/object.md) 調整を作成します。 **顧客請求書残高** で **残高の調整** をクリックして、**クレジット残高調整** モーダルを表示します。 次のような調整に関する情報を設定できます。 - **調整タイプ**: クレジットまたはデビットを選択します - **通貨**: 顧客が通貨を設定していない場合にのみ使用できます - **金額** - **内部メモ**: ダッシュボードのユーザーに表示されますが、顧客には表示されません ![顧客のサブスクリプション残高を調整する方法。](https://b.stripecdn.com/docs-statics-srv/assets/2-Customer-balance.ed7d6df96ba2b8595461e1091e4da7a9.png) ### API 以下のコード例に示すように、[Customer Balance API](https://docs.stripe.com/api/customer_balance_transactions/create.md) を使用して調整を作成します。 ```curl curl https://api.stripe.com/v1/customers/cus_4fdAW5ftNQow1a/balance_transactions \ -u "<>:" \ -d amount=-500 \ -d currency=usd ``` ## 請求書残高の取引履歴 ダッシュボードの顧客詳細ページの **顧客請求書残高** で、顧客の請求書残高の調整を監査します。 このセクションには、請求書残高の現在の値が表示されます。**詳細を表示** をクリックすると、その値の計算に使用された取引履歴が表示されます。各取引明細行には、請求書残高を適用した請求書へのリンクや、残高を貸方記入したクレジットノートなど、[取引タイプ](https://docs.stripe.com/billing/customer/balance.md#types)に関連する情報が表示されます。 ![請求書残高の取引履歴を表示](https://b.stripecdn.com/docs-statics-srv/assets/3-Balance-history.446845092bb178c7924a9cbee2538f94.png) ### API [顧客残高リスト](https://docs.stripe.com/api/customer_balance_transactions/list.md)を使用して、顧客のすべての取引のリストを取得します。 ```curl curl https://api.stripe.com/v1/customers/cus_4fdAW5ftNQow1a/balance_transactions \ -u "<>:" ``` ## 顧客の現金残高 [銀行振込](https://docs.stripe.com/payments/bank-transfers.md)の決済手段を使用する顧客には、`available` オブジェクトに 1 つ以上の通貨を持つ [cash balance オブジェクト](https://docs.stripe.com/api/customers/object.md#customer_object-cash_balance) があります。その残高を使用して[決済を行う](https://docs.stripe.com/payments/customer-balance.md#make-cash-payment)ことも、請求書を支払うこともできます。利用可能な残高を持つ顧客には、以下のような特徴があります。 - 残高は `Customer` から送られた資金を表すため、マイナスの現金残高は作成できません。 - 小さすぎる金額または大きすぎる金額のインボイスは現金残高では確定できません (0.01 USD のサブスクリプションの作成など)。詳細については、[最低金額と最高金額](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts)をご覧ください。 - `Customers` に現金残高がある場合は、現金残高が 0 の場合にのみ削除できます。 - `Customer` の使用可能な残高を削除することはできません。