image-studio

充值链路从 wx.chooseWXPay 切到 /pay/checkout/[id] 网关统一收银

症状

62a67ea 上线后,微信内浏览器可拉起付款,但 iOS 微信 H5 / 外部浏览器有概率拉不起 — 用户截图找客服,日志里 WeixinJSBridge is not defined 间歇出现。同时商户号 v3 平台证书 + secret + AppID 散落在每个 MVP 项目各自的 .env,谁泄漏谁背锅。

根因

微信支付有两条调起路径:客户端 JSAPI(wx.chooseWXPay)只在微信内置浏览器 + 公众号 OAuth 拿到 openid 后稳定,在 H5 外部浏览器和部分 webview 必断;JSAPI 走网关统一收银台则由网关侧 redirect 到带签名的付款页、由网关侧调起再 redirect 回业务方 — 这条路把 SDK 调起的环境检查、商户号配置、回调验签全收口到一处。

修法

(1) 62a67ea 集成 wxpay_jsapi via wx-gateway:POST /api/checkout/start → 网关 /pay/create,落 Payment(status=pending) 拿 { payOrderId, checkoutUrl }。(2) c5ef489 改用统一收银台页:前端直接 window.location.href = checkoutUrl 跳 https://wx.mvp.restry.cn/pay/checkout/[id],弃 wx.chooseWXPay。(3) Webhook → /api/wx/payment-webhook 事件 payment.paid 加积分事务幂等(39c9948)。

commit

62a67ea 接入 · d02f73b /topup 加 wxpay 按钮 · c5ef489 切统一收银 · 79df947 middleware 双因子放行后台可查 Payment。

// app/api/checkout/start/route.ts
const r = await fetch(`${WX_GATEWAY_BASE}/pay/create`, {
  method: 'POST',
  headers: hmacHeaders(WX_GATEWAY_APP_NAME, WX_GATEWAY_SECRET, body),
  body: JSON.stringify({ openid, amountFen, returnUrl: '/topup?paid=1' })
})
const { payOrderId, checkoutUrl } = await r.json()
await prisma.payment.create({ data: { payOrderId, userId, status: 'pending', ... } })
// 前端拿到 checkoutUrl 后:window.location.href = checkoutUrl  ← c5ef489 切点