取消订单接口

概述

用于用户取消待支付订单。

• 调用方：小程序前端
• 请求方式：POST
• 请求路径：/orders/{orderId}/cancel
• 请求头要求：Authorization、X-Idempotency-Key

请求参数

参数	类型	必填	说明
orderId	path string	是	订单 ID
reason	string	否	取消原因

返回参数

参数	类型	说明
orderStatus	string	取消后状态

成功响应示例

{"code":"0","message":"ok","data":{"orderStatus":"cancelled"}}

失败响应示例

错误码

• A0001
• B1004：当前订单状态不允许取消

接口约束

• 幂等要求：是
• 缓存策略：不缓存
• 一致性要求：强一致

前后端同步规则

取消订单成功后需要：

1. 释放库存
2. 刷新订单列表
3. 刷新订单详情