退款

介绍

退款（Refund）是支付完成后（即交易已经请款、资金已到账）的一种逆向交易，用于将部分或全部款项退还给持卡人。它是售后流程中非常重要的一环。
退款有可能不是实时到账持卡人账户，可能会需要数个工作日的时间。

退款

请求示例 Refund

{
  "merchant_id": "18356675194960",
  "refund_trans_id": "m43986y4t345436",
  "ori_order_id": "GW20620xxxxx6999",
  "timestamp": 1745922548689,
  "refund_amount": 100,
  "currency": "USD",
  "notify_url": "https://notify_url"
}

成功响应示例

{
  "ret_code": "000000",
  "ret_msg": "Success",
  "data": {
    "merchant_id": "18356675194960",
    "refund_trans_id": "m43986y4t345436",
    "refund_order_id": "RG206xxxxx198",
    "ori_order_id": "GW20620xxxxx6999",
    "status": "PROCESSING",
    "amount": 100,
    "currency": "USD"
  }
}

失败响应示例

{
  "ret_code": "010000",
  "ret_msg": "Invalid request"
}

退款结果查询

请求示例 Refund Query

{
  "merchant_id": "18356675194960",
  "refund_order_id": "RG206xxxxx198",
  "timestamp": 1745922570644
}

退款成功响应示例

{
  "ret_code": "000000",
  "ret_msg": "Success",
  "data": {
    "error_code": "0000",
    "error_description": "request success",
    "merchant_id": "18356675194960",
    "refund_trans_id": "1745922548689",
    "refund_order_id": "RG206xxxxx198",
    "ori_order_id": "GW20620xxxxx6999",
    "status": "SUCCESS",
    "amount": 100,
    "currency": "USD"
  }
}

退款失败响应示例

{
  "ret_code": "000000",
  "ret_msg": "Success",
  "data": {
    "error_code": "2010",
    "error_description": "The bookkeeping has failed for the refund",
    "merchant_id": "18356675194960",
    "refund_trans_id": "1745922548689",
    "refund_order_id": "RG206xxxxx198",
    "ori_order_id": "GW20620xxxxx6999",
    "status": "FAILURE",
    "amount": 100,
    "currency": "USD"
  }
}

错误码

参见交易错误码

结果通知

参考 Webhook