請求書の一部支払いのサポートを追加

新規情報

複数の Payment Intents を 1 つの Invoice に関連付けるためのサポートを追加しました。請求書の一部支払いや複数回の支払いを認めることで、企業や顧客は、支払いとキャッシュフローをより柔軟に管理できるようになります。また、関連付けられた支払いが paid ステータスになったタイミングを追跡する invoice_payment.paid Webhook も導入しています。一部支払い済みの請求書に対するクレジットノートの発行をサポートするため、Credit Note オブジェクトに mixed タイプ、pre_payment_amount フィールド、post_payment_amount フィールドを追加しました。

影響

請求書への複数の支払いの関連付け

Attach Payment API を使用して、複数の支払いを請求書に関連付けられるようになりました。

curl https://api.stripe.com/v1/invoices/{INVOICE_ID}/attach_payment \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d payment_intent={PAYMENT_INTENT_ID} \
  -d "expand[]"=payments

一部支払い済みの請求書に対するクレジットノートの発行

今後も Create Credit Note (クレジットノートの発行) メソッドを使用して、一部支払い済みの請求書に対してクレジットノートを発行することが可能です。クレジットノートは、最初に請求書の amount_remaining (および amount_due) を減らしますが、ゼロ以下になることはありません。Credit Note オブジェクトの pre_payment_amount フィールドは、この金額を追跡します。請求書の amount_remaining をゼロに減らした後の残額は、Credit Note オブジェクトの post_payment_amount フィールドに適用されます。pre_payment_amount と post_payment_amount の両方がゼロ以外の金額の場合、クレジットノートは mixed タイプになります。

クレジットノートの発行についての詳細は、Create Credit Notes API をご覧ください。

変更点

アップグレード