Appearance
退款订单查询
POST /api/refund/query
代码出处：jeepay-payment/pay/rqrs/refund/QueryRefundOrderRQ.java / QueryRefundOrderRS.java。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| mchNo | String(64) | 是 | 商户号 |
| appId | String(64) | 是 | 商户应用 ID |
| refundOrderId | String | 二选一 | 平台退款订单号 |
| mchRefundNo | String | 二选一 | 商户退款单号 |
| version / signType / reqTime / sign | String | 是 | 公共字段，见鉴权说明 |
响应参数（data）
| 参数 | 类型 | 说明 |
|---|---|---|
| refundOrderId | String | 平台退款订单号 |
| payOrderId | String | 原平台支付订单号 |
| mchNo / appId | String | 商户号 / 应用 ID |
| mchRefundNo | String | 商户退款单号 |
| payAmount | Long | 原支付金额（分） |
| refundAmount | Long | 退款金额（分） |
| currency | String | 货币代码 |
| state | Byte | 退款状态：0-订单生成，1-退款中，2-退款成功，3-退款失败，4-退款任务关闭 |
| channelOrderNo | String | 渠道退款单号 |
| errCode / errMsg | String | 错误码 / 错误描述 |
| extParam | String | 商户扩展参数 |
| successTime | Long | 退款成功时间（13 位毫秒） |
| createdAt | Long | 退款单创建时间 |
Java 示例（SDK）
java
// 使用 JSONObject 直接拼参（退款查询无专用模型类时）
com.alibaba.fastjson.JSONObject params = new com.alibaba.fastjson.JSONObject(true);
params.put("mchNo", "M1690858842671");
params.put("appId", "appId-demo");
params.put("mchRefundNo", "REFUND-20261105001");
JeepayResponse resp = client.queryRefundOrder(params);
System.out.println("state=" + resp.getByte("state"));curl 示例
bash
curl -X POST http://<服务器IP>:9216/api/refund/query \
-H 'Content-Type: application/json' \
-d '{"version":"1.0","signType":"MD5","reqTime":"20261105120004","mchNo":"M1690858842671","appId":"appId-demo","mchRefundNo":"REFUND-20261105001","sign":"<按签名算法计算>"}'