一部キャプチャーおよび支払いキャンセルフローの Refund オブジェクトを削除対応が必要な変更点

新規情報

次のフローでは、Refund オブジェクトの作成および支払いへの関連付けが行われなくなります。

• 一部キャプチャー
• 支払いのキャンセル (手動および自動)

対応処理が必要な変更である理由

この変更により、次のシナリオで実装が中断される可能性があります。

• 実装が、部分的なキャプチャーまたは支払いのキャンセルが返金オブジェクトを作成すると想定される場合。
• 実装が、部分的なキャプチャーが残高取引を 2 つ作成すると想定されている場合。

実装に影響が出る可能性のある詳細については、以下の内訳を参照してください。

影響力

この変更は、キャプチャーの差戻しや支払いのキャンセルを Refund オブジェクトまたは関連フィールドに依存している場合、システムに影響します。Refund オブジェクトを削除すると、次のフィールドまたはオブジェクトに影響します。

Refund オブジェクト

• キャンセルまたはキャプチャーの差戻しを表す Refund オブジェクトは作成されなくなります。
• 支払いインテントまたは支払いに関連するすべての返金を取得するために呼び出しても、返されません。
• Webhook イベントには表示されません。
• API レスポンスの Charge オブジェクトには表示されません。
• ダッシュボードには表示されません。

PaymentIntent オブジェクト

• expired という新しい cancellation_reason の値が導入されます。この新しい値は、オーソリの有効期限切れによりキャンセルされた支払いを表します。これは、以前使用されていた値 automatic に置き換わります。

Charge オブジェクト

• amount_captured は、支払いキャンセルフローで nil ではなく 0 になります。
• amount_refunded は、これらのアクションによって更新されなくなります。
• refunded は、支払いキャンセルフローで true ではなくなります。

取引残高

• 一部キャプチャーでは 1 つの残高取引のみ表示されます。差戻された金額と手数料を記載した残高取引は表示されません。
• キャプチャー額を記載した残高取引には、関連する支払いに対して承認された金額ではなく、キャプチャーされた金額が表示されます。

Webhook

• charge.refunded イベントと charge.refund.updated イベントは送信しません。
• Stripe はその後も各フローの charge.expired、charge.captured、payment_intent.canceled イベントを送信します。

Radar の支払いレビュー

• 該当する場合、支払いのキャンセル時に、refunded ではなく canceled の理由で Radar の支払いレビューが終了します。

変更点

アップグレード