プログラムでクレジットノートを作成する
open
または paid
のインボイスの残高を調整するには、クレジットノートを生成します。
注
ダッシュボードを使用したクレジットノートの処理については、クレジットノートの発行をご覧ください。
クレジットノートを作成するときは、3 つの方法でクレジット金額を適用できます。
- インボイスのラインアイテムから固定金額を割引します。
- インボイスのラインアイテムから数量を割引します。合計割引額は、割引数量にラインアイテムの単価を乗算した値になります。
- 説明、数量、単価を含むカスタム割引ラインアイテムを追加し、インボイスの合計額に割引を適用します。合計割引額は数量に単価を乗算した値になります。
Stripe では、各クレジットをラインアイテムと関連付けているため、可能な場合はインボイスのラインアイテムを割引することをお勧めしています。カスタム割引ラインアイテムを追加すると、クレジットが実際のインボイスのラインアイテムに関連付けられないため、レポート作成と追跡が困難になる場合があります。
注
インボイスのラインアイテムで割引タイプを組み合わせることはできません。たとえば、ラインアイテムの数量を割引すると、将来のクレジットノートではそのラインアイテムを、金額ではなく数量のみで割引できます。ラインアイテムの金額を割引すると、将来のクレジットノートではそのラインアイテムを、数量ではなく金額でのみ割引できます。
未払いのインボイスに対するクレジットノート
open
インボイスのクレジットノートにカスタムのラインアイテムを作成すると、インボイスの amount_due
はクレジットノートの custom_line_items
に基づいて減額されます。これは、既存の invoice_line_items
に対するすべての調整に加えて処理されます。たとえば、open
インボイスの未払い額が 100 USD で、quantity=1
と unit_amount=2000
を指定して custom_line_item
を作成すると、インボイスの新しい金額は 80 USD になります。
インボイスでは、クレジットノートは割引と税金が適用された後のアイテムとして表されるため、これは課税後の調整額です。インボイス金額は次の順序で計算されます。
- インボイスのラインアイテムの合計
- 割引
- 課税前のインボイスの合計
- 税金
- 顧客のクレジット残高
- 適用されるクレジットノート (総額に対して)
- 新たな未払い額
インボイスにクレジットノートを適用した結果、未払い金額がゼロになる場合、インボイスは自動的に paid
状態に移行します。既存のラインアイテムの数量または金額を変更する場合は、インボイス ID、ラインアイテム ID、および新しい数量または金額を渡します。ラインアイテムに数量と金額がある場合、更新できるのは数量のみです。それ以外の場合は、金額のみを変更できます。次の例では、数量を 2 個に調整しています。
クレジットノートにカスタムラインアイテムを作成するには、インボイス ID、説明、数量、および単価を渡します。オプションで税率も設定できます。この例では、クレジットノートに 10 USD のカスタムラインアイテムを作成します。
支払い済みのインボイスに対するクレジットノート
paid
インボイスに対してクレジットノートを作成する際には、インボイスの金額は変化しません。その代わりに、ユーザーは以下の 1 つ以上のオプションを選択できます。
アクション | 説明 |
---|---|
返金の作成 | インボイスの支払いを、顧客の支払い方法に返金します。 |
返金の関連付け | 既存の返金をインボイスの支払いに関連付けます。 |
顧客のクレジット残高への貸方記入 | 顧客のクレジット残高に貸方記入すると、それ以降のインボイスに自動的に適用されます。 |
Stripe 以外でのクレジット処理 | Stripe 外で調整された金額を、インボイスで貸方記入します。 |
次の例では、クレジットノートで返金を作成します。
ここでは、クレジットノートで顧客のクレジット残高への貸方記入を作成します。
複数のパラメーターを組み合わせることもできます。インボイスの amount
から返金額とクレジット額を差し引いた残りの金額は、通常は現金または小切手を使用して Stripe 外でクレジット処理されます。
クレジットノートを無効にする
未払いのインボイスの場合にのみクレジットノートを無効にできます。クレジットノートを無効にすると調整が反対仕訳され、インボイスの請求金額がクレジットノートの金額分増額されます。クレジットノートを無効にするには、以下を行います。
マイナスのラインアイテムにクレジットを適用するベータ
マイナスのインボイスのラインアイテムをクレジットできるようになりました。現在、この機能はプライベートベータです。早期アクセスをご希望の場合は、こちらからベータへの参加をリクエストしてください。
マイナスのラインアイテムのクレジット処理をご希望の場合
amount
または quantity
パラメーターを使用して、マイナスの金額をマイナスの invoice_line_item
に貸方記入できます。
たとえば、2 つのラインアイテムが含まれる open
のインボイスがあるとします。
quantity=1
およびunit_amount=10000
のプラスのラインアイテムquantity=1
でunit_amount=-5000
のマイナスのラインアイテム。
この例では、amount
パラメーターを使用して、両方のラインアイテムの全額を貸方記入します。
この例では、quantity
パラメーターを使用して同じことを行います。
以下の制限が適用されます。
- クレジットノートの合計金額はプラスのままである必要があります。
- マイナスのラインアイテムに貸方記入される合計金額は、マイナスである必要があります。
- マイナスのラインアイテムに貸方記入される合計金額は、ラインアイテムの金額未満にはできません。
custom_line_item
にマイナスの金額を貸方記入することもできません。 invoice_line_items
ではマイナスの金額のみがサポートされます。