# 2. 订单退款
# 简要描述
- 商户确认退款后,需要向SwiMove发送订单退款请求,SwiMove会为对应订单设置支付状态为已退款,并向已连接的打印机推送打印退款小票的指令。
# HTTP请求信息
# 请求URL
{domain}/open-api/order/jt/refund
# 请求方式
- POST
# 请求头
| 参数名 | 是否必填 | 类型 | 说明 |
|---|---|---|---|
| Content-Type | 是 | string | application/json |
# 请求体参数
| 参数名 | 是否必填 | 类型 | 长度 | 示例 | 说明 |
|---|---|---|---|---|---|
| appId | 是 | string | - | 45eebd745dcf0b5f6d6f9fcde28cd9fe8116a892 | 应用 id (SwiMove 提供) |
| storeKey | 是 | string | 100 | CVIEIYUNHTS0 | 店铺标识 (SwiMove 提供) |
| param | 是 | string | - | - | 请求参数字符串 |
| sign | 是 | string | - | param 的RSA签名 |
# Param 参数
| 参数名 | 是否必填 | 类型 | 长度 | 示例 | 说明 |
|---|---|---|---|---|---|
| orderNo | 是 | string | - | TB****32345 | Swifood 店铺订单号 |
| refundRemark | 否 | string | - | 退款备注 |
# 请求体示例
{
"appId": "45eebd745dcf0b5f6d6f9fcde28cd9fe8116a892",
"storeKey": "CVIEIYUNHTS0",
"sign": "abcdef",
"param": "{\"orderNo\":\"TB****32345\",\"refundRemark\":\"test refund\"}"
}
# 响应示例
# 状态码 Refer to this list
# 响应参数
| 参数名 | 类型 | 示 例 | 说明 |
|---|---|---|---|
| code | integer | 10000 | 状态码 Refer to List |
| message | string | success | 状态码说明 |
| data | object | - | 返回的参数 |
# Data 参数
| Parameter Name | Type | Example | Description |
|---|---|---|---|
| refundOrderSi | string | 00000001 | refund order si |
{
"code": 10000,
"message": "success",
"data": "{\"refundOrderSi\":\"00000001\"}"
}
# 失败响应示例
{
"code":21000,
"message":"Service error, please contact administrator",
"data":null
}