订单退款
POST
/api/shop/refund
接口概述
接口信息
https://xxx.com/api/shop/refund请求头（Header）
| 参数名 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| account | String | 账号 | account |
| pwd | String | 密码 | pwd |
| key | String | API 密钥 | key |
请求参数（Body）
| 参数名 | 类型 | 是否必填 | 描述 | 示例值 |
|---|---|---|---|---|
| order_no | String | 是 | 订单号 | 251108114280382 |
| refund_amount | String | 是 | 退款金额（保留两位小数） | 0.01 |
响应格式
退款成功响应
{
"code": 0,
"message": "退款成功",
"data": {
"order_no": "251108114280382"
},
"trace_id": "690ebaaa5e2cf"
}退款失败响应
{
"code": 1,
"message": "缺少参数",
"data": [],
"trace_id": "692931283c4d6"
}{
"code": 1,
"message": "订单不存在",
"data": [],
"trace_id": "692931283c4d6"
}{
"code": 1,
"message": "退款失败",
"data": [],
"trace_id": "692931283c4d6"
}{
"code": 1,
"message": "订单不支持退款",
"data": [],
"trace_id": "692931283c4d6"
}{
"code": 1,
"message": "可退款金额不足",
"data": [],
"trace_id": "692931283c4d6"
}状态码说明
| 状态码 | 描述 |
|---|---|
| 0 | 退款成功 |
| 1 | 退款失败（通用错误） |
响应字段说明
| 字段名 | 类型 | 描述 |
|---|---|---|
| code | Integer | 状态码，0 表示成功，非 0 表示失败 |
| message | String | 响应消息，描述操作结果 |
| data | Object/Array | 响应数据，成功时包含退款订单号信息 |
| data.order_no | String | 退款订单号，退款成功时返回 |
| trace_id | String | 追踪 ID，用于问题排查 |
trace_id 说明
trace_id字段用于接口调用的追踪和问题排查。当接口调用出现问题时，请提供该 ID 以便技术支持人员快速定位问题。请求参数
Header 参数
Body 参数application/json