支付集成
移动端当前可走通的用户路径是余额充值。支付渠道(微信 / 支付宝)与调起参数由后端按端区分;前端通过请求头 X-Client-Type 告诉后端当前端(miniapp、wechat_h5、h5、app,见 utils/request.ts)。
用户怎么走通
- 登录后进入「我的」→「我的余额」(
modules/user/pages/balance)。 - 点「立即充值」,选预设金额或自定义金额,再点「确认充值」。
- 弹出
d-payment-popup,选择微信支付或支付宝,点「确认支付」。 - 前端调用
POST /api/user/recharge,体为{ amount, channel }(channel为wechat或alipay)。 - 后端返回
payment_data;前端按端调起:- 微信小程序:
uni.requestPayment(provider: 'wxpay') - 微信内 H5:
WeixinJSBridge.invoke('getBrandWCPayRequest', …) - 普通 H5:若返回
h5_url则整页跳转
- 微信小程序:
- 支付结果页(
modules/payment/pages/pay-result)可用GET /api/payment/query?order_no=…查询是否已支付。
渠道异步回调由支付渠道服务器打到后端,不经 UniApp;前端只负责下单与调起收银台。
上文列出的 /api/user/recharge 与 /api/payment/query 均在 uniapp/src 有调用,并在 server/config/route.php 注册。
管理端配置入口
- 系统配置 中的支付分组:开关微信 / 支付宝、商户与回调相关项(具体键名以管理端表单为准,本文不列证书字段)。
- 渠道:公众号、小程序、开放平台的 AppID 等,供登录与按端支付解析使用。
- 管理端「支付」菜单可查看订单、退款与回调核对(见后端「内置模块」)。
未配置或未启用对应渠道时,下单会失败;先在后台配好再在真机 / 开发者工具联调。