退款查询
基本信息
| 接口名称： | 退款查询 | 状 态： | 已完成 | 接口路径： | POST /api/queryRefund | 更新时间： | 2025-03-17 23:57:22 |
| Mock地址： | https://apimock.e-buychina.com/mock/713/api/queryRefund | ||
请求参数
Headers:
| 参数名称 | 参数值 | 是否必填 |
| Content-Type | application/json | 是 |
Body:
| 参数名称 | 类型 | 必填 | 默认值 | 备注 | 其他信息 |
| uuid | string | 是 | 请求序列号 | 最大长度：50 最小长度：1 Mock：@now('yyyyMMdd')-@string('lower',32) | |
| appId | string | 是 | 请求AppId | 最大长度：50 最小长度：1 Mock：@natural | |
| action | string | 是 | 交易类型 | 最大长度：50 最小长度：1 Mock：queryRefund | |
| timestamp | number | 是 | 请求时间戳 | Mock：@timestamp | |
| signType | string | 是 | 签名类型 | 最大长度：20 最小长度：1 Mock：sha256 | |
| sign | string | 是 | 签名值 | 最大长度：500 最小长度：1 Mock：@natural | |
| lang | string | 是 | 语言 | 最大长度：50 最小长度：1 Mock：zh_CN | |
| content | object | 是 | 请求报文 | ||
| outTradeNo | string | 是 | 外部订单号。如果商户同时使用多个渠道，可以选用最小值 | 最大长度：32 最小长度：32 Mock：@natural(32, 128) | |
| refundTradeNo | string | 否 | 退款请求流水号 | 最大长度：32 最小长度：32 Mock：@string |
返回数据
| 参数名称 | 类型 | 必填 | 默认值 | 备注 | 其他信息 |
| uuid | string | 是 | 请求序列号 | 最大长度：50 最小长度：1 Mock：@now('yyyyMMdd')-@string('lower',32) | |
| success | boolean | 是 | 查询请求是否成功，不代表源交易成功与否。 | Mock：@boolean | |
| action | string | 是 | 交易类型 | 最大长度：50 最小长度：1 Mock：queryRefund | |
| timestamp | number | 是 | 返回时间戳 | Mock：@timestamp | |
| errorCode | string | 是 | 错误码 | 最大长度：50 Mock：@word | |
| errorMessage | string | 是 | 错误描述 | 最大长度：50 Mock：@csentence | |
| signType | string | 否 | 签名类型 | 最大长度：20 Mock：sha256 | |
| sign | string | 否 | 签名值 | 最大长度：500 Mock：@natural | |
| content | object | 是 | 返回报文 | ||
| refundStatus | string | 是 | 交易记录状态Paying支付中 Success成功 Fail失败 SubRefunded部分退款 Refunded已全部退款 | 最大长度：64 最小长度：1 Mock：@string | |
| refundTradeNo | string | 是 | 退款流水号 | 最大长度：64 最小长度：1 Mock：@string | |
| refundAmount | number | 是 | 总退款金额 | Mock：@natural | |
| currency | string | 否 | 币种 | 最大长度：5 Mock：@string | |
| outTradeNo | string | 是 | 商户交易订单号 | 最大长度：50 Mock：@string | |
| cashRefund | object | 是 | 支付退款结果 | ||
| refundAmount | string | 是 | 退款成功金额 | 最大长度：10 最小长度：1 Mock：@string | |
| thirdRefundOrderId | string | 是 | 渠道退款流水号 | 最大长度：10 最小长度：1 Mock：@string |
备注
查询退款，先交验返回退款状态refundStatus**，再校验返回退款金额refundAmount。以退款金额为最终实际退款金额** |
变更历史
| 变更日期 | 变更内容 |
| 2025-03-17 |
No Comments