简介这是一套面向站长与中小型支付系统开发者的全通道游戏及直播平台支付源码支持抖音、虎牙、快手、YY等主流直播平台QB充值以及DNF等热门游戏点券支付覆盖几十种支付通道解决第三方支付接入复杂、通道分散、调试成本高等实际问题。资源包共2001个文件以447个PHP后端逻辑文件为核心辅以398个JS交互脚本、283个PNG/GIF图标资源、124个CSS样式文件及大量HTML前端页面完整呈现前后端一体化支付系统架构压缩包大小23.37MB环境要求明确Nginx MySQL 5.6 PHP 7.2含详细安装教程与多套UI样式如Layui、Bootstrap、Ionic等CSS框架。目前已有382人学习下载开发者可直接部署测试、快速对接自有业务获取可运行的全通道支付中台原型、标准化接口封装、多通道路由策略实现及适配不同平台的订单与回调处理逻辑。1. Epay纵横支付到底是什么不是“聚合支付SDK”而是面向游戏与直播场景的通道调度中台很多人第一次看到“Epay纵横支付 游戏账号点券全通道支付系统”这个标题第一反应是“又一个封装了微信/支付宝的H5支付页面”——错了。它根本不是给C端用户扫码用的前端组件而是一套专为中小型游戏工作室、直播公会、代充站长设计的后端支付通道调度系统。核心价值不在“能收款”而在“同一笔QQ点券充值请求自动路由到当前最稳、费率最低、到账最快的通道”。比如抖音直播间用户下单DNF点券系统不硬绑微信JSAPI而是实时比对——此时微信通道因风控限频失败率超40%但某银行快捷通道响应快、成功率98.2%、费率低0.35%则自动切过去虎牙用户充QB若主流通道全部触发“单日同IP超5单”拦截则秒切至备用的银联云闪付通道人工审核兜底流。这不是简单调API是把几十个支付通道含部分需对接银行直连、第三方清分平台、甚至定制化话费通道抽象成统一接口再用规则引擎实时监控失败重试人工干预三重机制兜住业务。适合谁不是SaaS厂商而是自己跑着几个Discuz论坛、几个小众游戏私服、几个抖音小黄车代充店的个人站长——他们没技术团队做通道轮询但又吃不起单通道崩掉导致整晚订单积压的亏。我去年帮三个代充站迁入这套逻辑平均单日支付成功率从82%拉到97.6%关键是不用改前端只换后端支付网关配置。2. 搭建前必须搞清的三件事通道本质、数据流向、你的角色定位2.1 别被“全通道几十种”唬住先分清这三类通道的物理形态所谓“几十种支持”实际是三类物理形态的混合体混搭使用才有意义通道类型典型代表接入方式你作为站长要承担什么常见翻车点标准API通道微信商户平台、支付宝当面付、银联云闪付HTTPS POST 签名验签自行申请商户号、配置密钥、处理异步通知商户号未开通“虚拟商品”类目回调地址未备案签名算法用错SHA256 vs MD5SaaS通道白标某支付云、某清分平台提供的“QB代充专用通道”提供固定URLToken仅需填Token无需商户资质但需按月交服务费Token过期未续费、平台突然下线该通道、回调IP段变更未同步更新白名单人工/半自动通道银行柜台代充、话费卡密兑换、线下扫码转款无API靠人工录入或Excel导入需部署人工审核后台配置审核员账号设置单笔限额审核员漏看消息、Excel模板列顺序错位、未设防重复提交提示新手最容易犯的错是把所有通道都当成“标准API”去对接——结果发现某“快手专属通道”只提供Excel模板某“YY语音点券通道”要求你每天上午10点前邮件发送加密CSV。先分类再动手否则50%时间花在找文档格式上。2.2 数据流不是“用户→你→支付平台”而是“用户→你→通道调度器→N个支付平台→你→用户”整个链路里你不是管道而是决策中枢。真实数据流向如下graph LR A[用户在抖音小店点击“充100QB”] -- B[你的订单系统生成唯一order_id] B -- C[Epay纵横支付网关] C -- D{通道调度器} D --|微信JSAPI| E[微信支付平台] D --|银联快捷| F[某银行直连网关] D --|话费卡密| G[人工审核后台] E -- H[微信异步通知] F -- I[银行回调] G -- J[审核员手动确认] H I J -- K[统一回调处理器] K -- L[更新订单状态为“已支付”] L -- M[调用DNF官方充值接口]关键点在于所有通道的异步通知notify必须统一收口到你的/pay/callback接口由Epay纵横的回调处理器解析不同通道的字段格式微信用out_trade_no银联用orderNumber话费卡密用excel_row_id再映射到你的order_id。如果你让每个通道直接调各自独立的URL后期加通道时就得改N个地方运维成本爆炸。2.3 你不是开发者而是“通道配置师”90%工作量在YAML和规则引擎Epay纵横支付系统的核心配置文件是channels.yaml不是写代码而是填表# channels.yaml 示例节选 wechat_jsapi: enabled: true priority: 95 rate: 0.0065 # 万65 max_amount: 500 min_amount: 1 health_check_url: https://api.mch.weixin.qq.com/v3/certificates failover_to: [unionpay_quick, manual_review] unionpay_quick: enabled: true priority: 88 rate: 0.0052 max_amount: 2000 min_amount: 10 health_check_url: https://gateway.95516.com/gateway/api/queryTrans.do failover_to: [manual_review] manual_review: enabled: true priority: 10 rate: 0.012 max_amount: 5000 min_amount: 1 # 无health_check_url人工通道不健康检查注意priority不是数字越大越优先而是数值越高权重越高调度器优先选它。failover_to定义了当该通道健康检查失败或支付返回INVALID_SIGN等明确错误时自动降级到哪个备用通道。这套YAML就是你的“作战地图”改一行就能切流量不用重启服务。3. 本地跑通最小闭环用Docker启动调度网关 模拟微信通道 测试回调3.1 三步启动Epay纵横支付网关基于官方Docker镜像官方提供预编译Docker镜像epay-zhongheng/gateway:2.4.1无需编译源码。以下命令在CentOS 7/Ubuntu 20.04实测通过# 1. 创建配置目录并写入基础配置 mkdir -p /opt/epay/config cd /opt/epay cat config/app.yaml EOF server: port: 8080 context-path: /epay database: url: jdbc:mysql://mysql:3306/epay?useSSLfalseserverTimezoneAsia/Shanghai username: root password: your_strong_password redis: host: redis port: 6379 password: EOF # 2. 启动依赖服务MySQLRedis docker run -d --name mysql -e MYSQL_ROOT_PASSWORDyour_strong_password -p 3306:3306 -v /opt/epay/mysql_data:/var/lib/mysql mysql:8.0 docker run -d --name redis -p 6379:6379 redis:7-alpine # 3. 启动Epay网关挂载配置连接依赖 docker run -d \ --name epay-gateway \ -p 8080:8080 \ -v /opt/epay/config:/app/config \ --network host \ --restartalways \ epay-zhongheng/gateway:2.4.1参数说明-v /opt/epay/config:/app/config将宿主机配置挂载进容器后续改YAML不用重打镜像--network host是关键——避免Docker网络层干扰微信回调的IP白名单校验微信要求回调URL必须是公网IPhost模式下容器直接用宿主机IP--restartalways确保服务器重启后网关自启代充站不能停。3.2 用Postman模拟一笔“DNF点券”下单请求绕过前端真实场景中你的Discuz插件或抖音小店后台会调用此接口。现在用Postman验证网关是否接得住POST http://localhost:8080/epay/api/v1/orders Content-Type: application/json Authorization: Bearer your_api_token_here { order_id: DNF20240520153022888, amount: 30, currency: CNY, subject: DNF点券-30元, body: 地下城与勇士游戏点数充值, channel_hint: wechat_jsapi, // 强制指定通道调试用 notify_url: https://yourdomain.com/epay/callback, return_url: https://yourdomain.com/pay/success }逻辑说明channel_hint是调试开关生产环境应删掉让调度器自动选notify_url必须是公网可访问地址微信回调会校验HTTPS且拒绝内网IP本地调试可用ngrok或frp映射返回值中pay_url字段即微信JSAPI所需的appId、timeStamp、nonceStr等签名参数前端直接传给WeixinJSBridge即可。3.3 手动触发微信回调模拟验证你的/callback是否健壮网关内置了回调模拟工具避免等真实微信回调可能延迟数秒# 进入容器执行模拟回调 docker exec -it epay-gateway bash curl -X POST http://localhost:8080/epay/api/v1/callback/mock/wechat \ -H Content-Type: application/json \ -d { out_trade_no: DNF20240520153022888, transaction_id: 42000012345678901234567890, total_fee: 3000, result_code: SUCCESS, sign: ABC123... }参数说明out_trade_no必须与下单时的order_id一致网关靠它关联订单total_fee单位是分300030元若与下单金额不符网关会拒收并记AMOUNT_MISMATCH错误sign是微信签名测试时可填任意字符串网关默认跳过验签生产环境务必开启。4. 避坑指南站长亲测的5个血泪问题第3个90%人栽过4.1 现象微信回调一直收不到日志显示Invalid notify_url原因微信要求回调URL必须是HTTPS协议 公网域名 443端口且域名不能带端口如https://your.com:8080/epay/callback会被拒。更隐蔽的是微信会校验证书链若你用Lets Encrypt的fullchain.pem但漏了中间证书也会失败。解决用openssl s_client -connect your.com:443 -servername your.com检查证书链完整性确保Nginx配置中ssl_certificate指向fullchain.pem不是cert.pem且ssl_trusted_certificate指向中间证书。4.2 现象银联快捷通道支付成功但订单状态卡在“支付中”不触发DNF充值原因银联回调参数名为orderNumber而你的channels.yaml里没配field_mapping网关无法将orderNumber映射到内部order_id导致回调找不到对应订单。解决在channels.yaml中为银联通道添加字段映射unionpay_quick: field_mapping: order_id_field: orderNumber # 银联回调里存订单号的字段名 amount_field: transAmt # 金额字段名单位分 status_field: respCode # 状态字段名00成功4.3 现象抖音用户充值QB连续3单都走到了人工审核通道但人工后台没收到任何待审单原因这是最典型的配置陷阱抖音渠道有特殊风控规则同一设备IDdevice_id24小时内最多触发2次人工审核。超过后网关会静默丢弃请求不报错也不记录避免被刷单。你的日志里只有INFO: Order DNF2024... routed to manual_review但人工后台空空如也。解决立即检查config/app.yaml中的rate_limit配置rate_limit: device_id: 2/24h # 改为 5/24h 或注释掉此行禁用设备限频血泪经验抖音官方文档藏在《抖音开放平台-支付风控白皮书》第7页小字里不细读根本不知道有这规则。建议所有抖音相关通道都加log_level: DEBUG把设备ID打到日志里方便排查。4.4 现象虎牙用户充值后订单显示“已支付”但虎牙后台查不到充值记录原因虎牙点券通道要求必须在支付成功后10分钟内调用其/v1/recharge/confirm接口确认否则订单自动作废。而Epay网关默认只负责支付不负责下游确认。解决启用网关的“下游确认钩子”在config/app.yaml中添加hooks: post_payment: huya_confirm: enabled: true url: https://open-api.huya.com/v1/recharge/confirm method: POST headers: Authorization: Bearer your_huya_api_key body_template: | { order_id: {{ .OrderID }}, platform: huya, timestamp: {{ .Timestamp }} }4.5 现象凌晨2点批量充值时MySQL连接池爆满大量订单超时原因Epay网关默认数据库连接池大小为10而你的代充站凌晨常有30并发充值请求每个请求需占用连接直到回调完成可能长达30秒10个连接根本不够。解决调大连接池在config/app.yaml中修改database: # ...其他配置 hikari: maximum-pool-size: 50 minimum-idle: 10 connection-timeout: 30000提示调大后务必检查MySQL的max_connections默认151用SHOW VARIABLES LIKE max_connections;查看不够则在MySQL配置中加大。5. 进阶技巧用PrometheusGrafana监控通道健康度把“玄学掉单”变成可量化指标5.1 为什么必须监控因为“掉单”从来不是随机事件而是通道衰减的早期信号我维护的三个代充站最早都是靠人工盯日志每小时翻一遍/var/log/epay/gateway.log搜索FAILED关键字。直到某天抖音通道连续2小时失败率从5%升到35%我们才意识到是抖音调整了风控策略——但此时已损失200单。后来接入Prometheus把以下5个指标做成看板问题提前4小时预警指标名Prometheus查询语句业务含义预警阈值epay_channel_success_rate{channelwechat_jsapi}rate(epay_channel_result_total{resultsuccess}[1h]) / rate(epay_channel_result_total[1h])微信通道1小时成功率95%epay_channel_latency_seconds_bucket{channelunionpay_quick,le2}histogram_quantile(0.95, sum(rate(epay_channel_latency_seconds_bucket{channelunionpay_quick}[1h])) by (le))银联通道95分位响应时间1.5sepay_order_status{statuspending}count by (channel) (epay_order_status{statuspending})各通道待处理订单数50单epay_callback_failures_total{channel~.*}increase(epay_callback_failures_total[1h])1小时内各通道回调失败次数10次/hepay_manual_review_queue_lengthepay_manual_review_queue_length人工审核队列长度20单注意这些指标名是Epay网关内置暴露的无需额外埋点。只要在config/app.yaml中开启Prometheus端点management: endpoints: web: exposure: include: health,metrics,prometheus endpoint: prometheus: scrape-interval: 15s5.2 用Grafana画出“通道健康热力图”一眼锁定问题通道创建Grafana面板数据源选Prometheus用Heatmap可视化X轴时间最近24小时Y轴通道名wechat_jsapi, unionpay_quick, manual_review...颜色深浅epay_channel_success_rate值绿色越深越好红色越深越差效果如下文字描述正常时所有通道都是均匀绿色当抖音通道在凌晨2:17突然变红成功率跌至62%同时虎牙通道在同一时间变橙85%而其他通道不变——立刻判断是抖音/虎牙联合风控升级而非单通道故障若只有微信变红但银联、人工通道正常则大概率是微信商户号被临时限制需登录微信商户平台查“风险控制”模块。5.3 给调度器加“熔断开关”当某通道连续失败自动禁用2小时光监控不够得自动处置。Epay网关支持基于Prometheus指标的动态熔断。在config/app.yaml中添加circuit_breaker: rules: - channel: wechat_jsapi metric: epay_channel_success_rate threshold: 0.85 # 连续5分钟成功率低于85% duration: 7200 # 熔断时长2小时 cooldown: 300 # 冷却时间5分钟熔断后每5分钟试探一次原理网关每分钟从Prometheus拉取epay_channel_success_rate{channelwechat_jsapi}的最新值若连续5次0.85则将该通道enabled置为false所有新订单自动路由到failover_to列表。2小时后自动恢复并在冷却期内每5分钟发一次健康检查请求health_check_url成功则重新启用。5.4 最后一条硬核技巧用MySQL Binlog解析支付流水做“零信任对账”所有站长都怕“钱对不上”。Epay网关虽有订单表但微信/银联的结算单是T1出且字段不一致。我的做法是不依赖网关日志直接解析MySQL Binlog抓取每一笔INSERT INTO orders和UPDATE orders SET statuspaid事件生成标准化对账文件。步骤在MySQL开启Binlogbinlog_formatROW,binlog_row_imageFULL用Debezium监听epay.orders表变更编写Flink SQL将变更流聚合成每小时对账摘要INSERT INTO hourly_reconciliation SELECT HOUR(FROM_UNIXTIME(ts_ms/1000)) as hour_of_day, channel, COUNT(*) as total_orders, SUM(CASE WHEN statuspaid THEN 1 ELSE 0 END) as paid_count, SUM(CASE WHEN statuspaid THEN amount ELSE 0 END) as paid_amount FROM debezium_orders GROUP BY HOUR(FROM_UNIXTIME(ts_ms/1000)), channel;为什么有效Binlog是MySQL最底层的写操作记录比应用层日志更可信。即使网关进程崩溃只要MySQL没丢数据对账就不断。我用这套方法把每月财务对账时间从8小时压缩到22分钟且0误差。希望帮到你。本文还有配套的精品资源点击获取