【支付系统】彩虹易支付使用手册[搭建必看]

源码购买与下载：

服务器环境

推荐使用宝塔、AMH等面板一键部署服务器环境。

• PHP版本：>=7.4，推荐8.0
• MySQL版本：5.6、5.7、8.0

伪静态配置

直接上传后访问即可完成安装！创建好网站之后，需要配置伪静态才能正常发起支付。以下分别是Nginx、Apache、IIS服务器的伪静态配置方法：

Nginx

如果是nginx，伪静态规则在源码包根目录的nginx.txt文件里面。
将nginx.txt里面的全部内容复制，粘贴到宝塔伪静态配置的输入框里面，点保存即可。

Apache

如果是Apache，伪静态规则在.htaccess里面，默认配置好的，不需要单独修改。

IIS

如果是IIS，伪静态规则在IIS.txt里面，复制粘贴到宝塔伪静态配置的输入框里面，点保存即可。

定时任务

置好定时任务之后，才可以实现每日0点定时生成结算列表与资金统计。

在后台找到计划任务配置，如下图所示

将 订单统计任务 与 自动生成结算任务 的网址添加到宝塔的《计划任务》功能中，具体参数如下图所示。

订单异步通知重试任务 不是必须的，可以不用添加！

站点配置

网站信息配置

• 在 系统设置->网站信息配置 里面，可以配置网站名称、SEO信息、客服QQ、注册开关、测试支付开关、验证码开关等。
• 如果开启注册付费或测试支付，需要事先在用户列表，手动添加一个用于自己收款的商户！

支付与结算配置

• 在 系统设置->支付与结算配置 里面，可以配置支付最大最小金额、商品屏蔽关键词、支付IP黑名单、支付账号黑名单、结算开关、结算规则等。
• 支付账号黑名单的拦截只支持支付宝JS支付与微信公众号支付方式，支付宝黑名单填写2088开头的UserId，微信黑名单填写用户在公众号对应的Openid。
• 结算总开关默认开启自动结算，结算周期选T+1，这种情况下在每日0点如果定时任务正常执行，则会自动生成结算列表。管理员可以在第二天进行结算，实现资金T+1到账。
• 结算周期如果选择T+0并且开启手动结算，则用户中心会显示手动提现菜单，用户可以实时提现全部的商户余额（不推荐此种模式）。

接口配置

企业付款

企业付款

企业付款是用于批量转账的，包含支付宝、微信、QQ的转账接口，都需要企业资质才能申请到。

支付宝转账接口

需要申请《转账到支付宝账户》，申请地址：https://b.alipay.com/signing/productDetailV2.htm?productId=I1012000291000001000
添加支付插件为“支付宝官方支付”的支付通道，选中即可使用。

微信企业付款接口

需要先在微信支付后台开通企业付款功能。
添加支付插件为“微信官方支付”的支付通道，选中即可使用。
结算账号必须都为Openid，用户前台可以扫码自助获取。

QQ钱包企业付款接口

需要先在QQ钱包支付后台开通企业付款功能。
添加支付插件为“QQ钱包官方支付”的支付通道，密钥配置处需填写操作员ID和操作员密码，即为登录QQ商户平台的账号密码。

批量转账

如果没有企业资质，支付宝、网商银行等可以使用网页版的批量付款功能，直接导入Excel就能批量转账。在生成的结算批次点击“下载CSV”，稍微变更一下格式就能提交支付宝批量付款。

实名认证

实名认证接口主要分为3大类：支付宝扫码认证、微信扫码认证、运营商手机号三要素认证。

支付宝扫码认证

• 支付宝身份验证：申请地址，该接口费用1元/人，支持人脸识别，同一个人重复验证不重复收费。
• 支付宝实名信息验证：申请地址，该接口完全免费，但不支持人脸，而且申请困难，基本上不给通过。
• 阿里云金融级实人认证：申请地址｜获取密钥，该接口费用1元/人，支持人脸识别，同一个人重复验证不重复收费。无需签约，只需要阿里云企业认证账号即可开通。

微信扫码认证

• 微信扫码实名认证：申请地址｜获取密钥，接口0.3元/次。

运营商手机号三要素认证

• 手机号三要素实名认证：点击进入

常见问题

用户支付成功，但是后台订单显示未支付

1. 首先去上游支付接口网站查看订单，状态是否已支付，如果是未支付，那就是上游支付网站的问题，不是你自己网站的问题！
2. 检查伪静态是否已经配置正确，可以点击左侧“搭建教程”查看。
3. 在后台网站信息配置里面，有个“回调专用网址”，必须留空，或填写正确的能访问的网址！
4. 服务器有开启防火墙、防CC的，需要关闭，否则上游支付接口无法异步通知到本站！
5. 域名有接入高防CDN、Cloudflare的，需要把域名改成解析到源站才可以！
6. 极少数国内支付机构，不支持境外服务器回调，需要迁移到国内服务器。
7. 去上游支付网站点重新通知（补单），可以重试异步通知。

用户支付成功，后台对应订单显示已支付，但是商户网站没有订单或显示未支付

1. 最主要原因是用户支付成功后直接关闭了网页或者直接点返回了，没有等页面跳转回商户网站。
2. 除此之外还可能是商户网站服务器有防火墙、防CC，或域名接入了高防CDN等，导致易支付无法异步通知到商户网站。
3. 如果商户网站是自行开发对接的，也可能是对接的有问题，点击补单跳转后的页面报错就说明对接的有问题，需要商户网站根据开发文档自行检查代码。
4. 在订单列表点重新通知（补单），可以重试异步通知。

微信公众号支付，提示redirect_uri域名与后台配置不一致

• 需要在【微信公众平台->公众号设置->功能设置】设置网页授权域名。

微信公众号支付，提示当前页面的url未注册

• 需要在【微信支付商户平台->产品中心->开发配置】设置JSAPI支付授权目录，直接填写你自己网站首页的网址即可。

网站出现各种奇怪的问题，例如点击什么都会提示服务器错误，或者登录后还是显示未登录，退出登录后还是登录状态、登录后显示别人的账户等

• 检查服务器是否安装了“堡塔网站加速”插件，如果有的话必须卸载！
• 检查网站域名是否接入了CDN。例如腾讯云等CDN，会把全站都给缓存，除非单独配置缓存规则改成不缓存。如果不会配置，建议不要用CDN。