覆盖单账号、多账号轮询、云端挂机的完整部署方法与排障手册。先看原理,再照步骤做。
买家下单 → 平台展示收款码(可多码轮询) → 买家扫码付款
→ 钱进入【收款码对应的账号】
→ 该账号所在手机收到官方到账通知
→ 手机上的监控 APP 提取金额,上报平台
→ 平台按「支付方式 + 金额(含随机尾数)」唯一匹配订单 → 订单完成
三条关键对应:
| 概念 | 说明 |
|---|---|
| 收款码 | 钱的入口,轮询 = 多个码按订单轮流展示 |
| 账号 | 收款码背后实名的微信/支付宝/QQ 账号 |
| 监控手机 | 挂着该账号、装了监控 APP、能收到到账通知的手机 |
一句话: 哪个账号的码在收款,就必须有一台挂着这个账号的手机在做监控。
· 安卓手机或安卓云手机(安卓 8.0+,建议 12/14);
· 手机已登录收款用的微信/支付宝/QQ;
· 苹果手机无法做监控(系统限制),必须安卓或安卓云手机。
管理后台 → 监控设备 → 添加设备 → 复制设备 Token(48 位)。
手机浏览器打开平台 → 软件下载 → 下载 KunPayMonitor.apk 安装。
填入平台地址(如 https://pay.example.com)与设备 Token,点「保存并连接」,顶部变绿"设备在线"即成功(30 秒/次心跳)。
| 授权 | 作用 |
|---|---|
| 通知使用权 | 监听收款通知(核心),APP 内按钮跳转系统设置开启 |
| 通知权限 | Android 13+ 必需,缺了系统停发通知事件 |
| 电池白名单 | 防杀后台掉线 |
厂商杀后台额外设置:小米(自启动+无限制省电)、华为(手动管理全开)、OPPO/vivo(自启动+后台运行)。
创建小额订单 → 手机真实支付 → 观察通知 → APP 日志"已上报" → 平台订单变已支付。
渠道管理 → 对应渠道 → 绑定该设备:绑定后只接受该设备上报,防多设备串单。
一台手机 = 一个微信 + 一个支付宝 + 一个 QQ(三通道独立开关)。N 个账号两种形态:
形态一(标准): 每账号一台手机/云手机 账号1 → 手机 A(Token A) ┐ 账号2 → 手机 B(Token B) ├→ 全部上报平台 → 按金额匹配 账号3 → 手机 C(Token C) ┘ 形态二(同账号多码): 一台手机监控该账号,天然覆盖所有码
开启轮询: 管理员在渠道管理添加多码开轮询(可设权重);商户在「我的通道」绑定多码开轮询。建议每个渠道绑定对应监控设备。
为什么不会串单: 平台为每笔订单追加随机尾数(¥10 → ¥10.37),同刻在途订单金额全站唯一,到账只可能匹配那一笔。
购买安卓云手机(红手指/河马/多多云等)→ 按第三节部署 → 云手机 7×24 在线。
有 Linux 服务器也可以 自建云手机: 开源 redroid 方案(Android in Docker),
一台服务器跑 N 台安卓容器,每台装 KunPay Monitor 监控一个收款账号;
完整教程见 GitHub 仓库 deploy/redroid自建云手机教程.md(含 docker-compose 多实例编排
与一键初始化脚本)。
| 症状 | 原因与处理 |
|---|---|
| APP 显示等待收款通知不动 | 通知使用权未授予 / Android 13+ 通知权限未允许 / 通知无"收款"关键词 |
| 心跳在线但订单不匹配 | 金额或支付方式不符 / 渠道绑定了其他设备 / 订单已过期 |
| 锁屏后掉线 | 电池优化杀后台,设置厂商白名单 |
| 两台设备同时上报 | 渠道绑定专属设备即可 |
| 同金额订单互相干扰 | 保持"金额尾数偏移"开启 |
| 苹果手机 | 不支持,用安卓或安卓云手机 |
排查万能三步: ① 平台设备列表看在线;② APP 实时日志看有没有"→ 上报";③ 平台「到账流水」看记录,未匹配可手动匹配。
设备 Token 等同上报钥匙,泄露立即重置;只监控你自己的收款账号;微信/支付宝官方对非正常收款有风控,请控制频率与场景,商用依法合规。