請求書の複数 (一部) 支払いのサポートを追加しました破壊的変更

新規情報

請求書とクレジットノートで複数 (一部) 支払いのサポートを導入する予定です。請求書が過払いと不定期決済をサポートするようになりました。加えて、Invoice オブジェクトに confirmation_secret フィールドを追加し、Payment Element の使用サポートを強化する予定です。

この変更により互換性が失われる理由

• Invoice オブジェクトから payment_intent、charge、paid、paid_out_of_band フィールドを削除しました。
• Payment Intent (支払いインテント) オブジェクトと Charge (支払い) オブジェクトから invoice フィールドを削除しました。
• Credit Note オブジェクトのrefund フィールドを廃止し、refunds 配列に置き換えました。
• Invoice オブジェクトの amount_paid フィールドに不定期決済が反映されるようになりました。

影響

決済と請求書の接続を表す Invoice Payment オブジェクトを導入し、関連オブジェクトから以前の請求書と決済のポインターを削除しました。1 つの請求書を 1 回の決済で一括払いする必要があると仮定しないようにシステムを更新し、新しい Invoice Payment オブジェクトを使用して決済と請求書の関係を把握する必要があります。

invoice.payments 配列で決済情報を調べる

invoice.payments は、Invoice オブジェクトを操作する際に payments プロパティを展開することで調べることができます。

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

invoice.payments 配列は、請求書に関連付けられているすべての決済と、それぞれの割り当てと決済ステータスのリストを提供します。

決済と請求書の関連付けには、新しい Invoice Payment エンドポイント を使用する

Payment Intent と Invoice オブジェクトの関係を理解するには、List Invoice Payment エンドポイント を使用します。

curl -G https://api.stripe.com/v1/invoice_payments \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment[type]"=payment_intent \
  -d "payment[payment_intent]"={PAYMENT_INTENT_ID}

Payment Element の実装には confirmation_secret を使用します。

Payment Element の実装、特にサブスクリプションの実装では、以前は invoice.payment_intent.client_secret または latest_invoice.payment_intent.client_secret の拡張に依存していましたが、confirmation_secret を展開することで、Invoice オブジェクトの新しい invoice.confirmation_secret.client_secret フィールドを使用できるようになりました。

curl -G https://api.stripe.com/v1/invoices/{INVOICE_ID} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "expand[]"=confirmation_secret

変更点

Upgrade