# 顧客のクレジット残高 顧客のクレジット残高の処理方法をご紹介します。 > #### 顧客残高のタイプ > > このページでは、顧客のクレジット残高について取り上げています。クレジット残高とは、顧客に対して発行できる調整であり、将来の*請求書* (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)に充当されます。クレジット残高は現金残高とは異なります。現金残高は、[顧客残高の支払い方法](https://docs.stripe.com/payments/bank-transfers.md)に関連付けられています。詳細については、[銀行振込](https://docs.stripe.com/invoicing/bank-transfer.md) をご覧ください。以下で説明するように、現金残高を持つ顧客については、一部の機能の動作が異なります。 すべての顧客にクレジット残高があります。これを使用して、以下を発行することができます。 - **貸方調整**: お客様が顧客に支払うべき金額があります。 - **借方調整**: 顧客がお客様に支払うべき金額があります。 これらの調整はクレジット残高に合計され、将来の請求書に充当することができます。クレジット残高は元帳 (借方取引と貸方取引の変更不可能なリスト) から計算されるため、顧客に関する取引の監査証跡が提供されます。[Customer Balance Transaction (顧客の取引残高)](https://docs.stripe.com/api/customer_balance_transactions/object.md) は、調整に関連するオブジェクト ([クレジットノート](https://docs.stripe.com/invoicing/dashboard/credit-notes.md)や請求書、または [メタデータ](https://docs.stripe.com/api/metadata.md)) も参照できます。 顧客のクレジット残高の一般的なユースケースです。 - [クレジットノートを発行](https://docs.stripe.com/invoicing/dashboard/credit-notes.md#issuing)して、次回の請求書の請求金額を減らすクレジットを作成する。 - 請求書が支払い済みとしてマークされ、未払い額は借方としてクレジット残高に移動されます。これが行われるのは、請求書の請求金額が[最小請求可能金額](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts)より少ない場合です。この機能は、[現金残高](https://docs.stripe.com/invoicing/customer/balance.md#cash-balances)のないユーザーのみを対象としています。 ## クレジット残高 クレジット残高を処理する際には、次の点に注意してください。 - クレジット残高は、顧客への次回の確定済み請求書に自動的に充当されます。 - クレジット残高を充当する請求書を選択することはできません。 - クレジット残高には顧客の通貨が使用されます。 - [cash balance (現金残高)](https://docs.stripe.com/api/customers/object.md#customer_object-cash_balance) が設定された顧客は、プラス残高を維持できません。言い換えると、顧客は次の請求書の請求額を増やすことができません。 ## クレジットとデビット クレジットはマイナスの値 (顧客が支払うべき金額の減額) で、次回の請求書に充当できます。一方、デビットはプラスの値 (顧客が支払うべき金額の増額) で、次回の請求書に適用できます。 ## 取引 クレジット残高に対する変更はすべて、[取引](https://docs.stripe.com/api/customer_balance_transactions/object.md)として記録されます。取引の作成後に更新できるものは、`description` および `metadata` だけです (その他のプロパティーの編集や、取引の削除はできません)。 ### 取引タイプ 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` となります。`adjustment` の type 値は、お客様のために手動で作成したデビットまたはクレジットを表します。以下の表では、各 `type` の値について説明しています。 | タイプ | 説明 | | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `adjustment` | クレジット残高にデビットまたはクレジットを実行するために明示的に作成された調整取引。これは、API の組み込みとダッシュボードを使用して作成できる唯一の取引タイプです。 | | `applied_to_invoice` | 関連付けられた請求書に対するクレジットの適用を追跡します。 | | `credit_note` | [クレジットノート](https://docs.stripe.com/invoicing/dashboard/credit-notes.md)およびそれに関連付けられた請求書へのクレジットの作成を追跡します。 | | `invoice_too_small` | 請求書の請求金額が Stripe の[最小請求可能金額](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts)より少なく、顧客に現金残高がない場合、その請求書はクレジット残高から借方記入され、次回発行される請求書の請求金額に追加されます。 | | `invoice_too_large` | 請求書の請求金額が Stripe の[最大請求可能金額](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts)より大きく、顧客に現金残高がない場合、その請求書はクレジット残高から借方記入され、次回発行される請求書の請求金額に追加されます。 | | `unapplied_from_invoice` | 関連付けられた請求書から適用されたクレジット残高の反対仕訳を追跡します。すでに行われている ‘applied_to_invoice’ 取引に対応するものです。 | | `unspent_receiver_credit` | 現金残高のない顧客に関連付けられた[受取人ソース](https://docs.stripe.com/sources.md#flow-for-customer-action)の未使用の売上が 60 日後に完全に支払われていない場合、Stripe はお客様の代わりに自動的にその金額を請求し、お客様の残高に貸方記入します。これが発生した場合、Stripe は対応するクレジット取引も作成します。 | | `initial` | ゼロ以外のクレジット残高で顧客が API で作成された場合の、クレジット残高の開始値を表します。 | ### 取引を取り消す 取引を取り消すには、対応する反対取引を作成しなければなりません。たとえば、顧客に 10 USD のクレジットを適用した取引を取り消すには、新たに顧客に 10 USD のデビットを適用する取引を作成して、相互に相殺する必要があります。 ## クレジット残高を修正する 顧客のクレジット残高の修正は、ダッシュボードからでも API でも行うことができます。 #### ダッシュボード ダッシュボードの[顧客ページ](https://dashboard.stripe.com/customers)で顧客のクレジット残高を変更するには、新しい[顧客の残高の取引](https://docs.stripe.com/api/customer_balance_transactions/object.md)調整を作成します。 **顧客** ページで顧客をクリックし、**クレジット残高** の **残高を調整** をクリックします。ここでは、**調整のタイプ**、**通貨** (顧客に通貨が設定されていない場合にのみ使用可能)、**金額**、および **内部メモ** を設定します。 > **内部メモ**は、ダッシュボードユーザーにのみ表示されます。 ![](https://b.stripecdn.com/docs-statics-srv/assets/2-Customer-balance.ed7d6df96ba2b8595461e1091e4da7a9.png) 新しい顧客の残高の取引調整を追加する #### API [顧客の残高 API](https://docs.stripe.com/api/customer_balance_transactions/create.md) を使用して調整を作成するには、以下のコードを参考にしてください。 If you represent your customers as [customer-configured Accounts instead of Customers](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md), pass the `Account` ID instead of the `Customer` ID (for example, `v1/customers/acct_xxxxx/balance_transactions`). ```curl curl https://api.stripe.com/v1/customers/cus_4fdAW5ftNQow1a/balance_transactions \ -u "<>:" \ -d amount=-500 \ -d currency=usd ``` ## 取引残高の履歴 #### ダッシュボード **顧客**ページで顧客の残高調整を監査するには、**入金残高**セクションまでスクロールします。このセクションには、顧客の入金残高の現在の値が表示されます。 #### API ### 取引を取得する 特定の顧客にかかわる全取引のリストを取得するには、[顧客の残高の一覧表示 API](https://docs.stripe.com/api/customer_balance_transactions/list.md) を使用します。 If you represent your customers as [customer-configured Accounts instead of Customers](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md), pass the `Account` ID instead of the `Customer` ID (for example, `v1/customers/acct_xxxxx/balance_transactions`). ```curl curl https://api.stripe.com/v1/customers/cus_4fdAW5ftNQow1a/balance_transactions \ -u "<>:" ``` ## 顧客の現金残高 [銀行振込](https://docs.stripe.com/payments/bank-transfers.md)の決済手段を使用する顧客には、[現金残高オブジェクト](https://docs.stripe.com/api/customers/object.md#customer_object-cash_balance)があり、`available` なオブジェクトに 1 つ以上の通貨を保有しています。この資金を使用して[決済を行う](https://docs.stripe.com/payments/customer-balance.md#make-cash-payment)か、請求書を支払うことができます。 > #### 顧客設定アカウントの現金残高を管理する > > 顧客設定の [Account](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-configuration-customer) を使用して顧客を表す場合は、`Customer` ID の代わりにその ID を渡すことで `Account` の現金残高にアクセスできます (例: `v1/customers/acct_xxxxx/balance_transactions`)。 利用可能な残高がある顧客の動作は以下のとおりです。 - 残高は `Customer` から送られた資金を表すため、マイナスの現金残高は作成できません。 - 小さすぎる金額または大きすぎる金額のインボイスは現金残高では確定できません (0.01 USD のサブスクリプションの作成など)。詳細については、[最低金額と最高金額](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts)をご覧ください。 - `Customers` に現金残高がある場合は、現金残高が 0 の場合にのみ削除できます。 - `Customer` の使用可能な残高を削除することはできません。 ## See also - [Stripe データ](https://docs.stripe.com/stripe-data.md)