Shopify POS 扩展升到 2026-10 后购物车折扣抛错

现象#

同一份代码在 2026-07 正常，把 api_version 改成 2026-10 后点应用折扣，控制台报 POS refused the cart update. The cart was not changed.，加载动画一直转。

原因#

• 2026-10 起 cart mutation 只在 POS 确认写入后才 resolve，否则直接 reject
• 收银员已进入支付页时 POS 不再接受购物车修改，写入被明确拒绝
• 网络抖动导致结果无法确认时返回 could not confirm，可能已经部分写入
• 未捕获的 rejection 会中断后续代码，loading 状态与界面更新都不执行

处理步骤#

1. 给每个 cart mutation 包 try/catch，把 setDiscountApplied(false) 放进 catch
2. 按消息分流：refused 提示稍后重试，could not confirm 先读购物车再决定
3. 重试前用 shopify.cart 的读取方法核对行项目与折扣，避免重复叠加
4. 短期改不完就把 api_version 留在 2026-07，处理补齐后再升
5. 在 POS 里故意走到支付页复现一次，确认 toast 关闭且没有残留 spinner

验收标准#

支付页触发写入时扩展弹出提示而不是卡住，返回购物车后折扣状态与实际行项目一致，控制台无未捕获的 promise rejection。