查询退款
接口说明
| 接口名称 | 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 | 与商户交易订单号对应的宝付侧唯一订单号，推荐传入此值 |
| 商户退款订单单号 | 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时，返回错误代码 |
作者：admin 创建时间：2025-03-21 18:44
最后编辑：admin 更新时间：2025-06-17 14:16
最后编辑：admin 更新时间：2025-06-17 14:16
