Skip to main content
根据退款交易号查询退款订单的当前状态。

​
接口信息

项目说明
请求方式GET
路径/api/merchant/order/refund/query/{transactionId}
Content-Type—（GET 请求无 Body）
鉴权方式RSA 签名

​
路径参数

参数类型必填说明
transactionIdString是商户退款交易号（发起退款时传入的 transaction_id）

​
响应参数

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "1000126011700000200001",
    "order_id": "1000126011700000100001",
    "merchant_id": "10001",
    "merchant_refund_id": "REF-20260101-001",
    "original_transaction_id": "ORDER-20260101-001",
    "refund_amount": 50.00,
    "refund_currency": "USD",
    "refund_time": "2026-01-01T12:00:00",
    "status": 2,
    "reason": "用户申请退款",
    "remark": "商品有瑕疵"
  }
}

​
字段说明

字段类型说明
idString平台退款单号
order_idString关联的订单号
merchant_idString商户 ID
merchant_refund_idString商户退款交易号
original_transaction_idString原支付商户交易号
refund_amountBigDecimal退款金额
refund_currencyString退款币种
refund_timeDateTime退款时间（ISO 8601）
statusInteger退款状态
reasonString退款原因
remarkString退款备注

​
退款状态枚举

状态码状态说明
0初始化退款已创建
1处理中退款处理中
2成功退款已完成
5已取消退款已取消
6失败退款处理失败

​
请求示例

curl -X GET "https://openapi.paymatrixpay.com/api/merchant/order/refund/query/REF-20260101-001" \
  -H "X-Merchant-Id: 10001" \
  -H "X-Timestamp: 1737008400000" \
  -H "X-Nonce: b4c5d6e7f8" \
  -H "X-Signature: <RSA_SIGNATURE>"

​
使用场景

  • 确认退款是否到账
  • Webhook 未收到时的状态确认
  • 后台对账核对退款记录

​
相关页面