Accept partial payments for invoices

Most invoices are paid with a single payment. For larger invoices, you can accept multiple, smaller payments. You can use both the Dashboard and the API to accept partial payments.

Capture partial payments

Partial payments for subscription invoices

For invoices that Stripe send automatically after finalization, you can accept partial payments for active subscriptions. If you use the API, the collection_method is set to send_invoice.

Partial payments aren’t supported for subscription invoices that are charged automatically. If you use the API, the collection_method is set to charge_automatically.

The subscription lifecycle is mostly the same for subscription invoices with partial payments. However, invoices are considered paid only when they’re fully paid. If you use the API, this means amount_remaining is 0 and status=paid.

Invoice payment statuses

請求書の支払いには、それぞれのステータスがあり、これを使用すると、関連付けられている PaymentIntent を取得しなくても、支払いが成功したかどうかを確認できます。

一部のステータスでは、実行できる操作も制限されます。

• 請求書に open または paid の支払いがある場合は、請求書を無効にすることも、編集することもできません。
• 請求書に open の支払いがある場合は、回収不能のマークを付けることはできません。

If a payment fully pays the invoice, the status moves to paid. The status for subscription invoices won’t change after a payment is applied.

You can change a payment’s status from open to canceled by canceling its associated PaymentIntent.

Track partially paid invoices

You can check the status of invoices with partial payments on the Invoices page in the Dashboard. Add an Amount remaining column to display the remaining amount on the invoice.

After your customer partially pays an invoice, they see the remaining amount on the invoice and a partially paid status in their customer portal.

You can take one of the following actions on an invoice with a partially paid status:

• 支払いのために請求書を顧客に送信する。
• Change some elements of the invoice. To make more substantive changes, create a new invoice and void the old one.
• 請求書のステータスを paid、void、または uncollectible に変更する。

For any invoice payments that aren’t made by the due date, the overdue status takes precedence.

If you use the API, view the amounts_due and payments fields for invoice status details.

Prevent invoice overpayment

請求書に複数の open の支払いがある場合は、誤って請求書の過払いが行われる可能性があります。不要な支払いをキャンセルすることにより、過払いを防止することができます。

When an overpayment happens, Stripe automatically credits the excess funds to the customer’s credit balance. The balance transactions for these credits have an invoice_overpaid type.

Your integration can listen to the invoice.overpaid webhook to handle overpayments using a custom integration.

For example, to refund an overpayment:

1. Listen for the invoice.overpaid webhook.
2. amount_overpaid フィールドで返金額を指定します。
3. Retrieve the customer’s invoice_credit_balance. If the customer’s balance is less than the refund amount, the overpayment isn’t refunded because it might be applied to another invoice.
4. 顧客の残高を調整して、過払いのクレジットを差し引きます。
5. 返金を作成します。

クレジットノートを発行する

When you issue a credit note, Stripe attempts to reduce the invoice’s amount_remaining based on the credit note’s amount. If the credit note amount is greater than the invoice’s remaining amount, you must refund the excess to your customer.

You can preview a credit note to determine how much to refund to your customer. The pre_payment_amount tells you how much you’ll use to reduce the invoice’s amount_remaining, and the post_payment_amount tells you how much to refund to your customer.

Learn more about how credit notes work.

返金

When you create a credit note with a refund_amount, Stripe attempts to refund the invoice’s most recent payment. If you already issued a refund for that payment, or the refund amount exceeds the payment amount, the refund fails. To create a credit note in this situation, create the refunds separately and link them to the credit note using the refunds parameter.

Invoices with a refunded status require no action on your part.

制限事項

Be aware of the following limitations when using partial payments:

• The Stripe Connector for NetSuite doesn’t support partial payments.
• Your customers can’t pay a partial amount on the Hosted Invoice Page.