Shopify Storefront API

Storefront API 购物车属性写不进订单怎么办

现象#

用 cartAttributesUpdate 写了备注与自定义字段,结账后订单里看不到。

原因#

  • 写入 cart 后又被 cartCreate 重建,属性丢失
  • 属性 key 以 _ 开头但未在结账页展示
  • 用了 note 字段而不是 attributes

处理步骤#

  1. 用 cartAttributesUpdate(attributes: [{key, value}]) 写入并确认返回
  2. 结账前不要重建 cart,只更新
  3. 需要显示在结账页的字段加 cart.attributes 渲染,或改用结账 UI 扩展
  4. 订单生成后通过 customAttributes 校验

验收标准#

订单详情里能看到对应属性与备注,值与应用写入一致,多语言下不丢失。

本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。