Skip to main content
POST
取引を払い戻す
注意:以下の決済方法では返金はサポートされていません:PayPay、Pay-Easy、Konbini。

重要なポイント

  • 返金APIは、加盟店が取引を取り消し、資金を顧客の支払い方法に返金することを可能にします。
  • このAPIは、注文キャンセル、商品返品、または顧客が請求に異議を唱える場合などのシナリオで一般的に使用されます。
  • 返金は、返金リクエストに指定された金額に応じて部分的または全額で行うことができます。部分的に返金された場合でも、元の取引の残高は有効です。

フローダイアグラム

フローダイアグラム

APIパラメータ

承認

Authorization
string
header
必須

認証のためのAPIキー。形式:'Basic YOUR_API_KEY_HERE'

x-api-key
string
header
必須

x-api-key専用のAPIキー。

ボディ

application/json

取引を払い戻すためのリクエストペイロード。

transactionId
string
必須

承認された取引の元の取引ID。

Maximum string length: 36
:

"9dfd39ec-eb4a-4f8b-a526-17abf140a717"

amount
integer
必須

払い戻される金額。これはキャプチャまたは購入した金額を超えてはいけません。金額の制限は銀行によって異なります。

:

1000

merchant_id
string
必須

加盟店ID(DASMID)。

Maximum string length: 10
:

"< Merchant ID >"

notes
string

払い戻し取引の参照(オプション)。

Maximum string length: 128
:

"Refund amount captured/purchased"

レスポンス

201 - application/json

取引が正常に払い戻されました。

success
boolean

取引が成功した場合はtrue、失敗した場合はfalse。

:

true

status_code
integer

取引のステータスコード。

:

201

is_live
boolean

本番取引の場合はtrue、テスト取引の場合はfalse。

:

false

transaction_type
string

取引タイプ(例:REFUND)。

:

"REFUND"

gateway_response
object

ゲートウェイからの応答を含むJSONオブジェクト。

merchant_details
object

加盟店の詳細を含むJSONオブジェクト。

payment_details
object

取引の支払い詳細を含むJSONオブジェクト。

transaction_details
object

取引の詳細を含むJSONオブジェクト。