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

新規情報

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

影響

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

Attach Payment API を使用して、1 つの請求書に複数の支払いを関連付けることができるようになりました。

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

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

引き続き クレジットノートの作成メソッドを使用して、一部支払い済みの請求書のクレジットノートを発行できます。クレジットノートは、まず請求書の amount_remaining (および amount_due) を減らしますが、ゼロ未満にはできません。クレジットノートオブジェクトの pre_payment_amount フィールドは、この部分を追跡します。請求書の amount_remaining をゼロに減らした後の残額は、クレジットノートオブジェクトの post_payment_amount フィールドに適用されます。クレジットノートは、pre_payment_amount と post_payment_amount の両方がゼロ以外の場合 mixed タイプになります。

クレジットノート発行の詳細については、クレジットノート作成 API を参照してください。

変更点

アップグレード