Order Summaries, Ensure Refunds Async
支払プロバイダに要求を送信して、クレジットメモまたは超過資金の返金を確認します。この方法によってバックグラウンド操作が非同期ジョブキューに挿入され、その操作の ID が返されるため、ユーザはその状況を追跡できます。支払ゲートウェイ応答は、支払ゲートウェイログに表示され、バックグラウンド操作状況には影響しません。
- リソース
-
1/commerce/order-management/order-summaries/orderSummaryId/async-actions/ensure-refunds-async - 使用可能なバージョン
- 48.0
- Chatter が必要かどう��
- いいえ
- HTTP のメソッド
- POST
- POST のリクエストボディ
-
返金を非同期で確認の入力
- ルート XML タグ
- <ensureRefundsAsyncInput>
- JSON の例
-
1{ 2 "creditMemoId": "50gR000000000JNIAY" 3} - プロパティ
- POST のレスポンスボディ
-
- HTTP 状況コードで成功が示された場合、レスポンスボディは、Ensure Refunds Async Output です。それでもこのレスポンスボディが処理エラーを示す場合があります。
- HTTP 状況コードが 400 (クライアントエラー) または 500 (サーバエラー) の範囲内にある場合、レスポンスボディは、Error with Output です。output プロパティは Ensure Refunds Async Output です。enhancedErrorType プロパティの値は無視できます。
- 使用方法
-
このメソッドは、指定された OrderSummary に関連する OrderPaymentSummaries で返金金額についてチェックします。このチェックは次のロジックに従って行われます。
- クレジットメモが指定されている場合は、補足された金額が対応する請求書に充当された OrderPaymentSummaries を特定します。
- 該当する OrderPaymentSummaries を確認します。クレジットメモの金額と一致する補足された金額があれば、返金をその支払いに充当します。
- 完全に一致するものがない場合は、補足された金額がクレジットメモの金額よりも大きいものを探します。該当するものがある場合は、返金を最小の補足された金額に充当します。
- クレジットメモの金額を超える補足された金額がない場合は、補足された金額の大きい順に OrderPaymentSummaries を選択していきます。返金がなくなるまでそれらに充当します。
- 余剰資金の金額が指定されている場合は、補足された金額が請求書に充当されていない OrderPaymentSummaries を特定します。
- 該当する OrderPaymentSummaries を確認します。余剰資金の金額と一致する補足された金額があれば、その支払いに返金を充当します。
- 完全に一致するものがない場合は、余剰資金の金額よりも大きな補足された金額を探します。該当するものがある場合は、返金を最小の補足された金額に充当します。
- クレジットメモの金額を超える補足された金額がない場合は、補足された金額の大きい順に OrderPaymentSummaries を選択していきます。返金がなくなるまでそれらに充当します。
- クレジットメモが指定されている場合は、補足された金額が対応する請求書に充当された OrderPaymentSummaries を特定します。