学完能做什么
完成本教程后,你将获得一个可独立运行的聚合支付系统,具备以下能力:
- 对接支付宝、微信支付官方接口,实现自动化收款
- 生成固定或临时收款链接,适用于电商、发卡、订阅等场景
- 管理商户、查看订单流水、处理回调通知
- 拥有完整的数据统计与风控基础功能
前置条件
开始搭建前,请确认已具备以下资源:
| 资源项 | 最低要求 | 说明 |
|---|---|---|
| 服务器 | 1 核 1G / Linux | 推荐 CentOS 7.x 或 Ubuntu 20.04+ |
| 运行环境 | PHP 7.4–8.1 + MySQL 5.7+ | 需启用 curl、openssl、pdo_mysql、mbstring 扩展 |
| Web 服务 | Nginx 或 Apache | 需配置伪静态 |
| 域名 | 已备案(国内服务器) | 用于支付回调,必须可公网访问 |
| 支付商户号 | 支付宝当面付 / 微信 Native | 至少一个已审核通过的商户号 |
第一步:安装宝塔面板(可选但推荐)
宝塔面板可简化环境安装与站点管理。若你已熟悉命令行,可跳过此步。
- SSH 登录服务器,执行对应系统的安装命令:
# CentOS
yum install -y wget && wget -O install.sh https://download.bt.cn/install/install_6.0.sh && sh install.sh
# Ubuntu
wget -O install.sh https://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh
- 安装完成后记录面板地址、用户名和密码。
- 登录面板,在「软件商店」中安装:Nginx、PHP 7.4、MySQL 5.7。
- 在 PHP 设置中确认已启用扩展:
fileinfo、curl、openssl、pdo_mysql、mbstring,并删除proc_open禁用函数(彩虹易支付核心依赖此函数)。
第二步:创建站点并上传源码
- 在宝塔面板中点击「网站」→「添加站点」。
- 填写你的域名,创建数据库(记录数据库名、用户名、密码)。
- 下载彩虹易支付源码包,解压后将全部文件上传至站点根目录(通常为
/www/wwwroot/你的域名)。 - 设置运行目录为站点根目录(不要指向
public)。 - 在「网站设置」→「伪静态」中选择
thinkphp规则并保存。
第三步:安装系统
- 浏览器访问
http://你的域名/install。 - 按页面提示填写数据库连接信息(主机
localhost、数据库名、用户名、密码)。 - 设置后台管理员账号和密码,点击「安装」。
- 安装完成后删除
install目录,防止被重复安装覆盖数据。 - 访问
http://你的域名/admin登录后台,确认系统可正常进入。
预期结果:后台首页显示系统概览,无报错信息。
第四步:配置支付接口
以支付宝当面付为例:
- 登录支付宝开放平台,进入「控制台」→「产品」→「当面付」,确认已签约。
- 在「密钥管理」中生成应用公钥并上传,获取支付宝公钥。
- 记录以下参数:
AppID、支付宝公钥、商户私钥。 - 进入彩虹易支付后台 →「支付渠道」→「支付宝」→「当面付」。
- 填入上述参数,提交保存。
- 在「支付方式」中启用「支付宝」,设置费率(如 0.6%)。
- 点击「测试」按钮,输入 0.01 元,用支付宝扫码验证。
微信支付 Native 对接流程类似:在微信商户平台获取 AppID、商户号、APIv3密钥,并在后台对应位置填入。
第五步:配置回调与安全项
- 在站点配置中确认
https已启用(使用宝塔免费 SSL 即可)。 - 回调地址由系统自动生成,无需手动填写,但需确保域名可被支付宝/微信服务器访问。
- 后台「系统设置」中修改默认支付密钥(
key),用于 API 签名。 - 关闭后台「调试模式」,避免泄露敏感信息。
- 设置「订单超时时间」为 15 分钟,「最低支付金额」为 0.1 元。
常见问题排查
| 现象 | 原因 | 处理方式 |
|---|---|---|
| 安装页面空白 | PHP 版本不符或缺少扩展 | 切换 PHP 7.4,启用 fileinfo,删除 proc_open 禁用 |
| 支付回调不触发 | 域名不可访问或证书问题 | 检查 https 证书有效性,确认服务器防火墙放行 443 |
| 签名错误 | 密钥填反或包含空格 | 重新粘贴密钥,确保无换行;确认使用的是「支付宝公钥」而非「应用公钥」 |
| 后台登录 500 | runtime 目录无写入权限 | 执行 chmod -R 755 /www/wwwroot/站点/runtime |
| 订单已支付但状态未更新 | 回调 URL 被 WAF 拦截 | 在宝塔 Nginx 防火墙中放行支付宝/微信回调 IP 段 |
注意事项
- 彩虹易支付仅用于合法合规的收款场景,禁止用于赌博、诈骗、色情等非法用途。
- 正式运营前务必完成域名备案和支付商户号的企业认证。
- 定期备份数据库与
config.php配置文件,建议每日一次自动备份。 - 后台路径默认
/admin,建议通过 Nginx 规则修改为自定义路径以提升安全性。
© 版权声明
文章版权归作者所有,未经允许请勿转载。
相关文章
暂无评论...

