取引を払い戻す
サーバー間通信
返金API
返金APIは、成功した購入またはキャプチャ取引後に顧客に資金を返金するために使用されます。
POST
取引を払い戻す
重要なポイント
- 返金APIは、加盟店が取引を取り消し、資金を顧客の支払い方法に返金することを可能にします。
- このAPIは、注文キャンセル、商品返品、または顧客が請求に異議を唱える場合などのシナリオで一般的に使用されます。
- 返金は、返金リクエストに指定された金額に応じて部分的または全額で行うことができます。部分的に返金された場合でも、元の取引の残高は有効です。
フローダイアグラム
APIパラメータ
承認
認証のためのAPIキー。形式:'Basic YOUR_API_KEY_HERE'
x-api-key専用のAPIキー。
ボディ
application/json
取引を払い戻すためのリクエストペイロード。
承認された取引の元の取引ID。
Maximum string length:
36例:
"9dfd39ec-eb4a-4f8b-a526-17abf140a717"
払い戻される金額。これはキャプチャまたは購入した金額を超えてはいけません。金額の制限は銀行によって異なります。
例:
1000
加盟店ID(DASMID)。
Maximum string length:
10例:
"< Merchant ID >"
払い戻し取引の参照(オプション)。
Maximum string length:
128例:
"Refund amount captured/purchased"
レスポンス
201 - application/json
取引が正常に払い戻されました。
取引が成功した場合はtrue、失敗した場合はfalse。
例:
true
取引のステータスコード。
例:
201
本番取引の場合はtrue、テスト取引の場合はfalse。
例:
false
取引タイプ(例:REFUND)。
例:
"REFUND"
ゲートウェイからの応答を含むJSONオブジェクト。
加盟店の詳細を含むJSONオブジェクト。
取引の支払い詳細を含むJSONオブジェクト。
取引の詳細を含むJSONオブジェクト。