退款查询

按平台退款单号或商户退款单号，查询一笔已经成功的退款。

请求地址

https://z.weixiao.cc/refundquery，POST 表单。

请求参数

参数	类型	必填	说明
`pid`	String	必填	商户号，「API信息」里的商户号
`refund_no`	String	否	平台退款单号
`out_refund_no`	String	否	商户退款单号
`sign`	String	必填	签名
`sign_type`	String	否	签名类型

refund_no：申请退款时返回的 refund_no；与 out_refund_no 至少传一个，都传时以它为准
out_refund_no：申请退款时传的商户退款单号
sign：见「V1（MD5签名）」「V2（RSA签名）」
sign_type：MD5 或 RSA，不传按 MD5；签名方式为「RSA签名」的商户必须传 RSA

请求示例

curl -X POST 'https://z.weixiao.cc/refundquery' \
  --data-urlencode 'pid=1001' \
  --data-urlencode 'out_refund_no=RF20260927001' \
  --data-urlencode 'sign=你算出的签名' \
  --data-urlencode 'sign_type=MD5'

返回参数

参数	类型	说明
`code`	Int	返回码，`1` 为查到
`refund_no`	String	平台退款单号
`out_refund_no`	String	商户退款单号
`trade_no`	String	站长单号，退款的订单
`money`	String	退款金额，这一笔退款的金额，单位元
`status`	Int	退款状态，固定为 `1`，表示退款成功
`addtime`	String	申请时间
`endtime`	String	完成时间

返回示例

{
  "code": 1,
  "refund_no": "2026092712100012345",
  "out_refund_no": "RF20260927001",
  "trade_no": "2026092712000012345",
  "money": "1.00",
  "status": 1,
  "addtime": "2026-09-27 12:10:00",
  "endtime": "2026-09-27 12:10:02"
}

失败示例

{"code":-1,"msg":"退款记录不存在"}

两个退款单号都没传时返回「退款单号不能为空」。

注意事项

只返回已经成功的退款。还在处理中或已经失败的退款，查询结果同样是「退款记录不存在」。
申请退款返回「退款处理中」后，可以隔一段时间再查；也可以用同一个 out_refund_no 再次申请退款来确认结果，见「申请退款」。