监控APP对接

本平台通过「监控设备」接收收款到账通知。管理员在后台「监控设备」中添加设备获得 Token 后,在监控APP中配置即可。

方式一:平台自有协议

心跳地址:GET /monitor/heart?token={设备Token}

推送地址:GET /monitor/push?token={设备Token}&type={alipay|wxpay}&money={金额}&content={通知内容}

方式二:V免签(vmq)兼容协议

兼容 V免签监控APP,直接填入本平台地址与设备 Token 即可:

心跳地址:GET /appHeart?t={时间戳}&sign={md5(t+Token)}

推送地址:GET /appPushV?t={时间戳}&sign={md5(t+Token)}&type={alipay|wxpay}&money={金额}&content={通知内容}

返回格式

{"code": 1, "msg": "心跳成功"}
{"code": 1, "msg": "已匹配订单 20261012142704303043"}
{"code": 2, "msg": "已记录,未匹配到订单"}
{"code": -1, "msg": "设备token无效"}

云端挂机

自动监听需一台安卓设备(推荐部署在云手机上实现 7×24 挂机);Windows/macOS 监控助手可注册为系统服务在云服务器做心跳保活。平台支持主备设备自动接管:渠道绑定主设备后,主设备离线超过 5 分钟,备份设备的上报自动接管匹配。完整方案见仓库 deploy/云端挂机部署指南.md。

匹配规则

· 优先从推送内容中识别平台订单号精确匹配;· 否则按「支付方式 + 到账金额」精确匹配最早的待支付订单;· 为避免同额冲突,整数金额下单时会自动追加随机小数尾数(可在系统设置关闭);· 订单超时(默认 5 分钟)后不再参与匹配。

收款码轮询

商户中心「我的通道」中,同一支付方式可绑定多个自己的收款码:绑定 ≥2 个并启用后即可开启轮询,订单将按"最久未使用优先"轮流使用各个收款码,实现多码分摊收款。停用/删除导致启用码不足 2 个时轮询自动关闭;未绑定自有码的通道回落平台收款码。