源码系统概览
文章正文
通企付收银组件是一套对接聚合收银渠道的 PHP 源码包，把签名、验签、回调与金额单位这些细节封装成统一入口，业务侧只需要组装参数和读取结果。
组件作者为开发者 lty0311，文档声明采用 MIT 协议开源，仓库尚未附带独立许可文件，当前以 v2026.9.0 口径演进，README 最后更新 2026 年 6 月，支持 MD5 与 RSA 及国密签名。
源码简介
内置微信主扫、公众号支付、支付宝主扫与收银台四种常用支付方式，金额在方法参数层以元为单位自动换算成接口所需的分。
官方渠道提供了二十九个功能模块，组件核心只实现最常用的收单部分，其余能力通过扩展机制按需补充，升级不会覆盖自定义代码。
扩展基类封装了请求签名与响应验签流程，新增订单查询、余额查询或分账等模块时只需继承基类并声明方法。
把它和逐个对接官方接口的做法对比，区别在于 Composer 标准化的安装升级链路。
| 对比维度 | 通联支付组件 | 裸接官方接口 |
|---|---|---|
| 签名支持 | MD5 与 RSA 及国密可选 | 通常只实现单一算法 |
| 扩展方式 | 插件化注册不动核心代码 | 改动厂商目录难升级 |
| 金额处理 | 元到分自动转换 | 业务侧手工换算易错 |
| 回调验签 | 统一入口返回订单状态 | 各接口各自处理 |
需要接通企付收银的中后台系统可以直接引入这套组件，把精力留给业务逻辑本身。
适用场景
- SaaS 平台为商户提供聚合收银能力
- 企业内部充值与会员缴费场景对接
- 需要分账与提现等扩展模块的结算系统
技术栈与运行环境
组件通过 Composer 安装，PHP 环境建议 7.4 以上，依赖常见的 curl 与 json 扩展。
商户侧需要准备商户号、应用标识与对应算法的密钥材料，回调地址需外网可访问。
功能亮点
- 四种支付方式开箱即用
- 扩展机制支持订单账户结算三大内置模块
- 回调通知统一验签并返回结构化参数
- 订单状态码覆盖支付退款与关闭全流程
- 金额单位自动换算减少业务出错
技术架构与部署指南
安装与部署提示
通过 Composer 安装组件到业务项目。
composer require feihu/allinpay-tppay初始化时传入商户号、应用标识与签名密钥，即可发起一笔微信主扫下单。
$tqPay = new TqPay($config); $result = $tqPay->wxNative('1', '会员充值');异步回调处理只需调用验签方法，通过后按订单状态更新业务数据并应答平台。
if ($tqPay->verifyNotify($params)) { echo 'success'; }截图与演示说明
组件形态为后端接口库没有界面截图，使用效果以接口返回与回调数据为准。
按文档组装参数后可先在渠道沙箱环境联调，观察下单与回调链路的完整输出。
配置商户密钥后在沙箱环境发起下单，观察二维码生成与回调验签的完整链路。
常见问题
问. 金额单位是什么
渠道接口以分为单位，组件方法参数以元为单位并自动换算。
问. 支持哪些签名算法
支持 MD5 与 RSA 及国密三种，按商户配置选择即可。
问. 如何扩展新接口
继承扩展基类实现自定义方法并注册到实例上即可调用。
问. 回调验签失败怎么办
核对回调地址与密钥配置，确认报文未经中间层改写。
安全风险提示
仓库未附带独立许可文件但文档声明采用 MIT 协议，商用前建议与作者确认授权细节。
HTTP 客户端存在关闭证书校验的调用位置，生产环境应恢复校验并使用官方网关域名。
商户私钥属于敏感材料，务必存放在服务端安全位置，切勿提交到代码仓库。
下载说明
本页提供通联支付通企付组件完整源码打包下载，解压后按文档配置密钥即可联调。
压缩包内含组件源码与说明文档，扩展示例可直接参考仓库目录结构。
GitHub项目开源地址 https://github.com/lty0311/allinpay-tppay
