退款查询接口
通过此接口查询交易退款结果。
业务请求参数
| 字段名称 | 字段key | 必填 | 格式 | 备注 |
|---|---|---|---|---|
| 功能码 | funcode | M | String(5) | 定值：order.refund.query |
| 版本号 | version | M | String(1,8) | 固定值：1.0.0 |
| 应用编号 | appId | M | String(1,40) | 商户后台创建的应用ID |
| 商户退款订单号 | refundId | M | String(1,40) | 前缀"refund"+原商户订单号 |
请求示例报文
json
{
"appId": "000110011816681",
"funcode": "order.refund.query",
"version": "1.0.0",
"refundId": "refund75bb2D3F-2431-3A3A-FDD7-8C3B21191B55"
}接口同步返回
| 字段名称 | 字段key | 必填 | 类型 | 备注 |
|---|---|---|---|---|
| 功能码 | funcode | M | String(5) | 定值：order.refund |
| 版本号 | version | M | String(1,8) | 固定值：1.0.0 |
| 应用编号 | appId | M | String(1,40) | 商户后台创建的应用ID |
| 原商户订单号 | orderId | M | String(1,40) | |
| 商户退款单号 | refundId | M | String(1,40) | |
| 退款金额 | refundAmount | M | Number(22) | |
| 退款状态 | refundStatus | M | String(4) | 参见 交易状态 |
| 原平台订单号 | transId | O | String(1,60) | |
| 平台退款订单号 | refundTransId | M | String(0,64) | |
| 响应时间 | responseTime | M | String(14) | |
| 响应码 | responseCode | M | String(1.16) | 参见 交易响应码 |
| 响应信息 | responseMsg | N | String(1,200) | 参见 交易响应码 |
| 错误码 | errorCode | M | String(1,16) | 请求失败时返回 参见 交易错误码 |
| 错误信息 | errorMsg | M | String(200) | 请求失败时返回 参见 交易错误码 |
返回示例报文
json
{
"appId": "000110011816681",
"version": "1.0.0",
"funcode": "order.refund.query",
"orderId": "75bb2D3F-2431-3A3A-FDD7-8C3B21191B55",
"refundId": "refund75bb2D3F-2431-3A3A-FDD7-8C3B21191B55",
"refundAmount": "439560",
"refundStatus": "success",
"refundTransId": "refund2024010813I2H9O0",
"responseTime": "20240108142931",
"responseCode": "success",
"responseMsg": "请求成功",
}