优化客服权限

2026-07-10 12:00:23 +08:00
parent 763f5034fd
commit ca5433ada4
18 changed files with 467 additions and 120 deletions
@@ -0,0 +1,38 @@
+店铺订单取消
+对订单列表中的店铺订单发起取消。仅需传平台单号（platform_order_no）。取消规则比商户后台更严格：仅待绑定可取消，充值中不可「申请取消」。
+
+#接口地址
+code
+POST /api/open/v1/orders/cancel
+#请求方式
+POST
+
+#请求参数
+参数名	类型	必填	说明
+platform_order_no	string	是	店铺平台单号
+#响应参数
+| 参数名 | 类型 | 说明 | | --- | --- | --- | --- | | data.order.order_no | string | 平台内部单号 | | data.order.platform_order_no | string | 平台单号 | | data.order.recharge_status | number | 充值状态码 | | data.order.recharge_status_label | string | 充值状态中文 | | data.order.is_verifi | number | 核销状态（卡券单时有值） | | data.order.updated_at | string | 更新时间 |
+
+#响应示例
+json
+{
+  "code": 10000,
+  "message": "订单已取消",
+  "data": {
+    "order": {
+      "order_no": "202601011200001234",
+      "platform_order_no": "2617600561780683",
+      "recharge_status": 60,
+      "recharge_status_label": "已取消"
+    }
+  }
+}
+#常见失败
+message	说明
+店铺订单不存在	单号不存在或非店铺订单
+仅待绑定状态的订单可取消	订单已进入充值中等后续状态
+#说明
+鉴权与签名同 鉴权与签名。
+仅待绑定状态且走供货充值履约的店铺订单可取消；充值中、失败、人工等状态不可取消。
+取消后立即完成并退积分（按平台配置）。
+与商户端 POST /api/merchant/orders/cancel 相比：开放 API 不支持充值中「申请取消」，也不支持失败/人工介入等状态的取消；商户后台在上述状态仍可操作（充值中为软取消）。