# Shopro 微信交易合规插件

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

## 运营前置（必做）

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

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

## 安装

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

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

## 汇付配合

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

## CLI

```bash
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