退款查询

根据退款单号或商户退款单号查询退款订单状态。

请求接口

POST /open/cashier/trans/query/refund

通用参数

• 请求签名：Authorization Header，详见签名方法
• 客户端信息：Ikudot-Cashier-Client Header，详见客户端信息；

请求参数

参数	必填	类型	说明
refund_no	否	String	平台退款单号
out_refund_no	否	String	商户退款单号
is_refresh	否	Boolean	是否刷新上游渠道状态，默认 false

备注

refund_no 和 out_refund_no 至少传一个。

响应参数

参数	类型	说明
refund_no	String	退款单号
pay_no	String	原支付单号
pay_amount	Long	原支付金额（分）
payment	String	支付方式编码，参见支付方式
payment_name	String	支付方式名称
refund_amount	Long	退款金额（分）
refund_status	Integer	退款状态编码，参见支付状态
refund_status_name	String	退款状态名称
result_msg	String	结果说明
remark	String	备注
refund_time	String	退款申请时间，格式 yyyy-MM-dd HH:mm:ss
refund_succ_time	String	退款成功时间，格式 yyyy-MM-dd HH:mm:ss

请求示例

{
  "refund_no": "REF20260507000001",
  "is_refresh": true
}

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "refund_no": "REF20260507000001",
    "pay_no": "PAY20260507000001",
    "pay_amount": 100,
    "payment": "WXPAY",
    "payment_name": "微信支付",
    "refund_amount": 50,
    "refund_status": 200,
    "refund_status_name": "退款成功",
    "result_msg": "退款成功",
    "remark": "客户申请退款",
    "refund_time": "2026-05-07 11:00:00",
    "refund_succ_time": "2026-05-07 11:01:00"
  }
}