创建订单接口

概述

• 接口名称：创建订单
• 接口用途：生成积分或周边订单并锁库存
• 调用方：小程序前端
• 请求方式：POST
• 请求路径：/orders
• 请求头要求：Authorization、X-Idempotency-Key

请求参数

参数	类型	必填	说明
goodsId	string	是	商品 ID
channel	string	是	points / merch
deliveryMode	string	是	pickup / shipping
addressId	string	否	邮寄地址 ID
storeId	string	否	自提门店 ID

返回参数

参数	类型	说明
orderId	string	订单 ID
orderStatus	string	订单状态
itemCount	int	商品件数，固定为 1
pointsFrozenAmount	int	已冻结积分
payInfo	object	支付信息

payInfo 说明

• cashAmount：现金支付金额
• pointsAmount：积分支付数量

成功示例

{"code":"0","message":"ok","data":{"orderId":"o_1","orderStatus":"pending_payment","itemCount":1,"pointsFrozenAmount":100,"payInfo":{"cashAmount":29.9,"pointsAmount":100}}}

失败示例

错误码

• B1001
• B1002
• B1003
• A0003

接口约束

• 幂等要求：是，同一 X-Idempotency-Key 禁止重复创建订单
• 前后端同步规则：创建成功后进入支付或结果页
• 缓存/刷新策略：不缓存
• 一致性要求：强一致

业务说明

• 该接口同时支持积分订单与周边订单创建。
• 创建订单时需要同步执行库存锁定。
• 商品件数当前固定为 1。
• deliveryMode 为 shipping 时通常需提供 addressId；为 pickup 时通常需提供 storeId。