接口说明
| 接口名称 | refund_query |
|---|---|
| 是否幂等 | 否 |
| 接口模式 | 直连 |
| 异步通知 | 否 |
商户通过退款订单查询接口主动退款状态。
注意事项：
- 宝付退款订单号、退款订单号至少选择一个传入，推荐传入宝付退款订单号，如果同时传入，系统默认使用宝付退款订单号。
- 由于退款为系统异步处理，建议在提交申请退款1分钟以后发起查询，或者等待宝付支付系统异步通知退款结果。
- 调用申请退款接口，系统返回交易状态异常时，请调用查询接口确认订单状态。
接口参数
- 请求：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 代理商商户号 | agentMerId | 否 | S(16) | 100000 | 宝付支付分配的商户号 |
| 代理商终端号 | agentTerId | 否 | S(16) | 100000 | 宝付支付分配的终端号 |
| 商户号 | merId | 是 | S(16) | 100000 | 宝付支付分配的商户号 |
| 终端号 | terId | 是 | S(16) | 100000 | 宝付支付分配的终端号 |
| 退款订单号 | outTradeNo | 否 | S(50) | 20210315155012 | 商户系统内部退款订单号，同一个商户号下唯一 |
| 宝付订单号 | tradeNo | 否 | S(32) | 12312312312 | 与商户退款订单号对应的宝付侧唯一退款订单号， |
- 返回：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 宝付订单号 | tradeNo | 否 | S(32) | 12312312312 | 与商户订单号对应的宝付侧唯一订单号，推荐传入此值 |
| 商户订单号 | outTradeNo | 否 | S(32) | 20210315155012 | 商户系统内部订单号，同一个商户号下唯一 |
| 订单状态 | refundState | 否 | E | REFUND | 详见附录订单状态 |
| 完成时间 | finishTime | 否 | T | 20210315155012 | 订单状态为成功时才有值 |
| 成功金额 | succAmt | 否 | I | 100 | 单位：分，订单状态为成功时才有值 |
| 业务结果 | resultCode | 是 | S(16) | SUCCESS | SUCCESS：成功 FAIL：失败 |
| 错误代码 | errCode | 否 | S(32) | SUCCESS | 当业务结果FAIL时，返回错误代码 |
| 错误描述 | errMsg | 否 | S(128) | SUCCESS | 当业务结果FAIL时，返回错误代码 |
作者：xiaofeng 创建时间：2025-03-25 15:30
最后编辑：xiaofeng 更新时间：2025-06-05 10:43
最后编辑：xiaofeng 更新时间：2025-06-05 10:43
