顧客請求書残高

Stripe Billing のすべての顧客には、お客様がクレジットとデビットの調整を発行できる請求書残高があります。請求書残高の調整は、クレジット (お客様が顧客に支払うべき金額) またはデビット (顧客がお客様に支払うべき金額) となります。これらの調整では、顧客の今後の請求書に適用可能な残高が合計されます。

請求書残高は元帳 (デビット取引とクレジット取引の不変のリスト) から計算されるため、顧客に関する取引の監査証跡を提供します。お客様自身が確認できるように、これらの Customer Balance Transactions は、調整に関連するオブジェクト (クレジットノートや顧客)、または メタデータを参照します。

ユースケースの例

顧客の請求書残高の一般的な使用例を以下に示します。

• 次回の請求書の請求額を減らすクレジットを作成するために、クレジットノートを発行します。
• サブスクリプションのダウングレードに伴う比例配分によって、間接的にクレジットを作成し、次回の請求書の請求金額を減らすことができます。
• インボイスの請求金額が最小請求金額より少ない場合、インボイスは支払い済みとしてマークされ、未払い額はデビットとして請求書残高に移動されます。この機能は、cash_balance のない顧客のみが対象です。

顧客の請求書残高の詳細

顧客の請求書残高を使用する場合は、以下の詳細に注意してください。

• 請求書残高は、顧客の次回の確定済みインボイスに自動的に適用されます。
• 請求書残高を適用するインボイスを選択することはできません。
• 請求書残高をインボイスに適用しないようにすることはできません。
• 請求書の残高は顧客の通貨で表示されます。
• cash balance (現金残高) が設定された顧客は、プラス残高を維持できません。言い換えると、顧客は次の請求書の請求額を増やすことができません。
• 請求書残高は、invoice_creation が有効になっている Checkout セッションで作成された請求書には適用されません。
• 以前作成した未払い請求書に請求書残高を適用することはできません。ただし未払い請求書の編集では、請求書残高が請求書の修正に適用されます。

デビットとクレジット

マイナスの値は、顧客の次回の請求書に適用できるクレジット (顧客が支払うべき金額の減額) として扱われます。

プラスの値は、顧客の次回の請求書に適用できるデビット (顧客がお客様に支払うべき金額の増額) として扱われます。

取引

請求書残高に対するすべての変更は、取引として記録されます。作成後は、description または metadata のみを更新できます。他のプロパティを編集したり、トランザクションを削除したりすることはできません。

取引の取り消し

対応する差戻し取引を作成することによってのみ取引を取り消すことができます。たとえば、顧客に 10 USD のクレジットを適用する場合、新規取引で顧客に 10 USD のデビットを適用して、互いに相殺する必要があります。

取引タイプ

API またはダッシュボードで作成された取引のすべてに type 値の adjustment が設定されており、お客様が顧客に対して手動で作成したデビットまたはクレジットが表示されます。

type プロパティには、作成元や取引の理由を表すさまざまな値を指定できます。以下の表では、type の各値について説明します。

請求書の残高を修正

ダッシュボードで顧客の請求書残高を変更するには、顧客の詳細ページから新しい Customer Balance Transaction 調整を作成します。

顧客請求書残高 で 残高の調整 をクリックして、クレジット残高調整 モーダルを表示します。

次のような調整に関する情報を設定できます。

• 調整タイプ: クレジットまたはデビットを選択します
• 通貨: 顧客が通貨を設定していない場合にのみ使用できます
• 金額
• 内部メモ: ダッシュボードのユーザーに表示されますが、顧客には表示されません

API

以下のコード例に示すように、Customer Balance API を使用して調整を作成します。

curl https://api.stripe.com/v1/customers/cus_4fdAW5ftNQow1a/balance_transactions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=-500 \
  -d currency=usd

請求書残高の取引履歴

ダッシュボードの顧客詳細ページの 顧客請求書残高 で、顧客の請求書残高の調整を監査します。

このセクションには、請求書残高の現在の値が表示されます。詳細を表示 をクリックすると、その値の計算に使用された取引履歴が表示されます。各取引明細行には、請求書残高を適用した請求書へのリンクや、残高を貸方記入したクレジットノートなど、取引タイプに関連する情報が表示されます。

API

顧客残高リストを使用して、顧客のすべての取引のリストを取得します。

curl https://api.stripe.com/v1/customers/cus_4fdAW5ftNQow1a/balance_transactions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

顧客の現金残高

銀行振込の決済手段を使用する顧客には、available オブジェクトに 1 つ以上の通貨を持つ cash balance オブジェクト があります。その残高を使用して決済を行うことも、請求書を支払うこともできます。利用可能な残高を持つ顧客には、以下のような特徴があります。

• 残高は Customer から送られた資金を表すため、マイナスの現金残高は作成できません。

• 小さすぎる金額または大きすぎる金額のインボイスは現金残高では確定できません (0.01 USD のサブスクリプションの作成など)。詳細については、最低金額と最高金額をご覧ください。

• Customers に現金残高がある場合は、現金残高が 0 の場合にのみ削除できます。

• Customer の使用可能な残高を削除することはできません。