开通微信 Native（扫码）支付 — 操作清单

代码侧已全部就绪，只差商户平台开通与凭据配置。开通后无需改任何代码，B端「扫码收款」即可出码。
负责人：Lean（或财务，需商户平台管理员权限）

一、为什么要开通

现在酒店客账线上收款只有 JSAPI（客人在自己手机上、在小程序内付款）。

开通 Native 后，前台可以放一个二维码，让客人用微信扫一下就付——这是酒店前台最自然的收款方式。

二、开通步骤（微信支付商户平台）

  1. 登录 微信支付商户平台（需管理员账号）
  2. 进入 产品中心 → 我的产品
  3. 找到 Native 支付 / 扫码支付，点击开通（如已开通则跳过）
  4. 若有「申请开通」需要先填写：经营场景（选「线下门店/面对面收款」）、预计交易量等，通常即时或 1 个工作日内通过
注意：Native 支付是商户号维度的产品，和小程序 JSAPI 共用同一个商户号，不需要新开商户号。

三、需要确认的配置（开通后）

配置项说明当前状态
WXPAY_MCH_ID商户号已有（JSAPI 在用）
WXPAY_APP_ID / WX_APP_ID绑定的 appid已有
商户 API 私钥、证书序列号与 JSAPI 共用已有
WXPAY_NOTIFY_URL支付回调地址已有，需确认指向 /api/miniapp/pay/notify
WXPAY_SANDBOX沙箱开关必须为 false（否则不发起真实下单）

我们的回调接口已支持酒店收款单（回调找不到商品订单时会去识别 folio_charges 并自动入账），

所以回调地址不用新增，复用现有的即可。

四、开通后验证

  1. 打开 B端 → 客账 → 点开一笔未结账账单
  2. 底部「线上收款」区块点 扫码收款，填金额
  3. 应弹出二维码 + 提示"请让客人扫码支付"
  4. 用微信扫码付 1 分钱 → 点「查询是否已付」→ 应提示"已收款，客账已入账"，余额相应减少

若仍提示「线上支付暂未配置」，说明服务端凭据没读到，检查 .env 里上述变量并重启容器。

五、代码侧已就绪的东西（不用再开发）