xionggeshop/addons/shopro_wechat_trade

Shopro 微信交易合规插件

微信小程序购物订单 + 发货信息同步（upload_shipping_info / notify_confirm_receive）。

运营前置（必做）

在小程序后台（AppID 与商城配置一致）完成：

1. 签署 订单中心授权协议（否则 update_order_detail_path 报错 10060034）
2. 开通 发货信息管理服务（支付与交易 → 订单管理 / 购物订单）
3. 满足实物交易类小程序运营规范

安装

# 上传 addons/shopro_wechat_trade 后
php think shopro_wechat_trade:install
php think shopro_wechat_trade:verify

后台：系统管理 → 商城配置 → 微信交易合规

汇付配合

若使用汇付小程序支付，需同步部署最新 shopro_huifu（支付通知会落库微信 transaction_id）。

CLI

php think shopro_wechat_trade:init-path
php think shopro_wechat_trade:backfill
php think shopro_wechat_trade:retry-failed

触发点

• order_send_after → 异步 upload_shipping_info
• order_confirm_after（全部 item 已收货）→ notify_confirm_receive

小程序跳转

默认订单详情路径：pages/order/detail?id=${商品订单号}（微信官方示例用 id 传商户订单号）

安装报 10060035「无效的路径」

1. 先发布小程序：微信会校验 path 是否存在于当前线上版或提审版代码中；未发布 pages/order/detail 时会报此错
2. path 格式：pages/order/detail?id=${商品订单号}（不要前导 /）
3. 发布后再执行：php think shopro_wechat_trade:init-path
4. 或在小程序后台 支付与交易 → 订单管理 手动填写相同 path