加载中…
商品与交易接口

本组说明

本组覆盖电商完整交易闭环:逛商品(列表/详情/规格)→ 看评论 → 加购物车 → 结算(地址/运费/优惠券)→ 下单 → 去收银台(选支付方式/传支付凭证)→ 查订单/取消/确认收货 → 售后(见《会员接口》的 aftersale 篇)。

包含内容

  • 商品 product:列表、详情、规格属性,以及工作端商品维护(product/work);
  • 规格 attribute:商品规格/属性字典;
  • 评论 comment:商品评论列表与发表(含图片上传);
  • 订单 order:唯一入口聚合四个子链路——
    • 订单主体:我的订单列表、详情、取消、确认收货;
    • 购物车 order/cart:数量角标、加购、改数量、删除;
    • 结算 order/checkout:结算页数据、下单、支付成功页、切换配送方式、用券;
    • 收银台 order/cashier:支付方式列表、发起支付、上传支付凭证;
    • 工作端 order/work:订单处理、核销、改价、物流。

使用建议

  • 结算链路依赖 Cookie 会话(运费、优惠券暂存于 Session):浏览器端跨域必须 withCredentials: true 且服务端开启 credentials,详见《客户端约定与扩展字段》;
  • 购物车与订单接口全部要求登录令牌;
  • 下单前建议先调结算页接口(order/checkout)拿最新金额与配送选项,不要在前端自行计算运费与优惠;
  • 收银台传"支付凭证"后订单进入人工核验流程(以站点支付配置为准);
  • 商品详情中的价格相关字段仅供参考展示,实际以结算页金额为准。
添加日期:2026-10-06