顧客のクレジット残高
Stripe Billing の顧客のすべてにクレジット残高があり、お客様はこれを使用してクレジットとデビットの調整を発行できます。クレジット残高の調整は、クレジット (お客様が顧客に支払うべき金額) の場合も、デビット (顧客がお客様に支払うべき金額) の場合もあります。これらの調整は各顧客の残高に合算され、顧客の今後のインボイスに適用できます。
クレジット残高は元帳 (借方取引と貸方取引の変更不可能なリスト) から計算されるため、その顧客の取引の監査証跡を提供します。この Customer Balance Transactions (顧客の残高取引) では、調整に関連するオブジェクト (クレジットノートや顧客)、さらには Metadata (メタデータ) を参照して、お客様ご自身で確認することができます。
ユースケースの例
顧客のクレジット残高の一般的な使用例を以下に示します。
- 次回のインボイスの請求金額を減らすクレジットを作成するために、クレジットノートを発行します。
- サブスクリプションのダウングレードに伴う比例配分 (日割り / 秒割り計算) によって、間接的にクレジットを作成し、次のインボイスの請求金額を減らすことができます。
- インボイスの請求金額が最小請求可能金額より少ない場合、インボイスは支払い済みとしてマークされ、未払い額はデビットとしてクレジット残高に移動されます。この機能は、 cash_balance が設定されていない顧客のみが対象です。
顧客のクレジット残高の詳細
顧客のクレジット残高を使用する際には、次の点に注意してください。
- クレジット残高は、顧客への次回の確定済みインボイスに自動的に適用されます。
- どのインボイスにクレジット残高を適用するかを選択することはできません。
- クレジット残高をインボイスに適用しないようにすることはできません。
- クレジット残高には顧客の通貨が使用されます。
- cash balance が設定された顧客は、プラスの残高を維持できません。言い換えると、顧客は次のインボイスの請求金額を増やすことができません。
デビットとクレジット
マイナスの値は、顧客の次回のインボイスに適用できるクレジット (顧客が支払うべき金額の減額) として扱われます。
プラスの値は、顧客の次回のインボイスに適用できるデビット (顧客がお客様に支払うべき金額の増額) として扱われます。
取引
クレジット残高に対する変更はすべて、Transactions (取引) として記録されます。取引の作成後に更新できるものは、description
および metadata
だけです。その他のプロパティの編集や、取引の削除はできなくなります。
取引の取り消し
取引を取り消すには、対応する反対取引を作成しなければなりません。たとえば、顧客に 10 USD のクレジットを適用した取引を取り消すには、新たに顧客に 10 USD のデビットを適用する取引を作成して、相互に相殺する必要があります。
取引タイプ
API またはダッシュボードで作成されたすべての Transactions (取引) の type 値は adjustment
であり、お客様が顧客に対してデビットまたはクレジットを手動作成したことが示されます。
type
プロパティには、作成元や取引の理由を表すさまざまな値を指定できます。以下の表では、type
の各値について説明します。
タイプ | 説明 |
---|---|
adjustment | クレジット残高にデビットまたはクレジットを適用するために明示的に作成された調整取引。これは、API の組み込みとダッシュボードを使用して作成できる唯一の取引タイプです。 |
applied_to_invoice | 関連付けられたインボイスに対するクレジットの適用を追跡します。 |
credit_note | クレジットノートおよびそれに関連付けられたインボイスへのクレジットの作成を追跡します。 |
invoice_too_small | インボイスの請求金額が Stripe の最小請求可能金額より少なく、顧客に現金残高がない場合、そのインボイスはクレジット残高に借方記入され、次回発行されるインボイスの請求金額に追加されます。 |
invoice_too_large | インボイスの請求金額が Stripe の最大請求可能金額より大きく、顧客に現金残高がない場合、そのインボイスはクレジット残高に借方記入され、次回発行されるインボイスの請求金額に追加されます。 |
unapplied_from_invoice | 関連付けられたインボイスから適用されたクレジット残高の差戻しを追跡します。すでに行われている ‘applied_to_invoice’ 取引に対応するものです。 |
unspent_receiver_credit | 現金残高のない顧客に関連付けられた受取人ソースの未使用の売上が 60 日後に完全に支払われていない場合、Stripe はお客様の代わりに自動的にその金額を請求し、お客様の残高にクレジットします。これが発生した場合、Stripe は対応するクレジット取引も作成します。 |
initial | ゼロ以外のクレジット残高で顧客が API で作成された場合の、顧客のクレジット残高の開始値を表します。 |
クレジット残高を修正する
ダッシュボードで顧客のクレジット残高を変更するには、顧客の詳細ページで新しい Customer Balance Transaction (顧客の取引残高) 調整を作成します。
下方へスクロールしてインボイスクレジット残高パネルを見つけたら、残高を調整をクリックしてクレジット残高調整モーダルを表示します。
ここでは、調整のタイプ (クレジットまたはデビット)や、通貨 (顧客に通貨が設定されていない場合にのみ使用可能)、金額、および内部メモ (ダッシュボードのユーザに表示され、顧客には表示されない) など、調整に関する情報を設定できます。
API
以下に示すコード例のように、Customer Balance API を使用して調整を作成します。
クレジット残高の取引履歴
ダッシュボードで顧客のクレジット残高調整を監査するには、顧客の詳細ページに移動してインボイスクレジット残高パネルまでスクロールします。
インボイスクレジット残高パネルにはクレジット残高の現在の値が表示され、詳細を表示をクリックすると、その値の計算に使用された取引履歴を確認できます。各取引行には、クレジット残高に適用されたインボイスへのリンクや、残高に貸方記入されたクレジットノートなどの、取引タイプに関する情報が表示されます。
API
特定の顧客の全取引のリストを取得するには、Customer Balance List API を使用します。
顧客の現金残高
銀行振込決済手段を使用する顧客には、available
オブジェクトに 1 つ以上の通貨を持つ Cash Balance (現金残高) オブジェクト があります。その残高を使用して決済を行うことも、インボイスを支払うこともできます。利用可能な残高を持つ顧客には、以下のような特徴があります。
残高は
Customer
から送られた資金を表すため、マイナスの現金残高は作成できません。小さすぎたり大きすぎる金額のインボイスは現金残高では確定できません (0.01 USD のサブスクリプションの作成など)。詳細については、最低金額と最高金額をご覧ください。
You can delete
Customers
that have a cash balance, but only if their cash balance is 0.Customer
の使用可能な残高を削除することはできません。