彩虹易支付[epay]最新原版 接口配置教程以及详细说明

彩虹易支付系统有强大的支付接口扩展能力，首先需要明白以下几个概念。

由于上文的篇幅限制，这里专门拿出来一个位置分5点说明解释，有需要的 直接翻阅。

• 支付通道配置
• 支付宝RSA密钥配置教程
• 从私钥证书中提取私钥
• 微信支付密钥配置说明
• 企业支付

支付通道配置

支付方式

支付方式用于定义发起支付的调用值（在前台开发文档里面显示）与支付方式名称。目前系统自带6种支付方式，它们的名称和调用值分别是支付宝(alipay)、微信支付(wxpay)、QQ钱包(qqpay)、云闪付(bank)、京东支付(jdpay)、PayPal(paypal)

支付插件

支付插件是对接某个支付平台的具体实现，可以自行开发定制。一个支付插件可以包含多种支付方式，例如《支付宝官方支付》插件只有1种支付方式alipay，《QQ钱包官方支付》插件只有1种支付方式qqpay，《威富通RSA》插件包含5种支付方式alipay、wxpay、qqpay、bank、jdpay

支付通道

支付通道需要管理员手动添加，每个支付通道都对应1个支付方式和1个支付插件，可以配置支付密钥与单独的费率。

添加支付通道

在支付通道列表点击添加，分别需要选择支付方式与支付插件，通道模式必须选“平台代收（默认）”，否则无法正常发起支付以及无法给用户正常增加余额！。
分成比例是填写的给商户分成比例，如果填写95即为用户支付100元到账商户余额95元，实际支付费率是5%
分成比例有2个地方可以配置，其中一个是支付通道信息这里，另外一个是用户组信息那里。分成比例优先级：用户组>支付通道。
部分支付插件如果不知道申请地址的，可以查看支付插件列表，上面有对应链接。

支付平台推荐

如果你有营业执照（企业、个体），推荐申请以下支付平台：

• 支付宝官方支付，申请地址，需申请电脑网站支付+手机网站支付（如果条件不足可以申请当面付，但是当面付稳定性不如电脑/手机网站支付）。
• 微信官方支付，申请地址，同时还需要有已认证的服务号或小程序，NATIVE支付=扫码支付，JSAPI支付=公众号支付和小程序支付。扫码支付只能在电脑或手机浏览器支付；H5支付只能在手机浏览器支付；公众号支付和小程序支付均可实现电脑+手机浏览器+微信内浏览器支付；APP支付仅支持iOS手机浏览器跳转微信。
• QQ钱包官方支付，申请地址，目前不开放申请。
• 哆啦宝，申请地址
• 汇商通盈，申请地址，支付插件使用“银联前置”
• 汇付，申请地址
• 汇付宝，申请地址
• 掌易收，申请地址
• 汇联支付，申请地址
• 新生支付，申请地址，支持“新生支付”或“新生易”插件
• 银盛支付，申请地址，同时支持“银盛支付”与“银盛e企通”插件
• 首信易支付，申请地址
• 银联商务，申请地址
• 通联支付，申请地址
• 联动优势，申请地址
• 富友支付，申请地址
• 杉德支付，申请地址
• 易票联支付，申请地址
• 付呗聚合支付，申请地址
• 快钱支付，申请地址
• 收钱吧支付，申请地址
• 火脸支付，申请地址
• 易宝支付，申请地址
• 随行付，申请地址
• 盛付通，申请地址
• 精秀支付，申请地址
• 智付，申请地址
• 海科融通，申请地址

如果你没有营业执照，可申请以下支付平台（有营业执照也可以申请）：

• 虎皮椒，申请地址
• XorPay，申请地址
• 蓝兔支付，申请地址
• 钱多多分账接口，申请地址
• 我爱支付，申请地址
• 其他易支付或码支付，支付插件使用“彩虹易支付”

如果你有海外公司，可申请以下支付平台：

• 支付宝国际版，申请地址
• 微信支付国际版，申请地址
• PayPal，申请地址
• Stripe，申请地址

支付宝RSA密钥配置教程

阅读此文档之前，要仔细分清【公】和【私】这2个字，如果你连这2个字都分不清的话就不要往下看了！！！
配置前确保已经签约支付产品，如果没有签约，即使是配置了密钥也无法发起支付！

1、进入支付宝开放平台页面，选择某个应用（签约后会自动生成一个基础应用，不需要自己创建应用），点击 详情，进入 应用详情页，左上方可以复制该应用的APPID，然后进入 开发设置 > 接口加签方式（密钥/证书）> 设置。

2、设置加签方式，选择 密钥 > 下一步。

3、下载支付宝开放平台密钥工具，安装完后打开。

4、加签方式和加密算法都保持默认，点击【生成密钥】，可以在结果页中看到生成的【应用公钥】、【应用私钥】

复制【应用私钥】填写到网站后台。

5、将刚才在软件里面生成的【应用公钥】填写到下方输入框内。确认上传后，点击忽略IP白名单设置，就会显示【支付宝公钥】了。

复制【支付宝公钥】填写到网站后台。

6、如果需要用到当面付JS支付或支付宝快捷登录，还需要配置授权回调地址，直接填写网站首页的URL即可。

提醒：网站后台需要用到的是【支付宝公钥】和【应用私钥】，千万不能搞混了！【应用公钥】和【应用私钥】是一一对应的，也就是填写到网站后台的【应用私钥】和提交到支付宝那边的【应用公钥】是同一对才可以！

支付宝RSA公钥证书配置教程

若使用单笔转账到支付宝、现金红包等出资类接口，则必须使用公钥证书模式，否则提交转账时就会出现“接口已升级”的错误提示。
1、进入支付宝开放平台页面，选择某个应用，点击 详情，进入 应用详情页，左上方可以复制该应用的APPID，然后进入 开发设置 > 接口加签方式（密钥/证书）> 设置。

2、设置加签方式，选择 证书 > 下一步。

3、打开密钥工具，进入 生成密钥 功能，
加签方式选择 证书，
填写 组织/公司，必须与支付宝主账号名称完全相同，
点击 生成CSR文件，可以点击 打开文件位置 查看生成的应用私钥、应用公钥和 CSR文件。

4、打开“应用私钥RSA2048-敏感数据，请妥善保管.txt”文件，将里面的内容复制到网站后台【应用私钥】输入框。
5、回到开放平台控制台，上传生成的 CSR 文件，设置安全联系人信息。点击 确认上传。

6、将生成的应用公钥证书、支付宝公钥证书、支付宝根证书 全部下载至本地，并上传到网站指定目录内，这3个文件均须保持原本的文件名。

如何从私钥证书中提取私钥

部分支付通道要用到pem格式的私钥文件，但是支付平台给的是带密码的私钥证书（jks、pfx或p12）格式。

使电脑软件KeyStore Explorer
1、下载KeyStore Explorer软件，选Windows的第一个就可以。下载后安装。
2、打开KeyStore Explorer，点击打开按钮，选择支付平台给你的pfx或p12格式的证书文件。

3、输入该私钥证书的密码，成功进入后如下所示

4、在私钥证书上点右键->Export->Export Private Key

5、密码还是输入和刚才一样的密码，导出类型选第一个

6、注意上面的Encrypt一定要取消勾选，下面选择导出的目录，然后点Export

7、导出成功，在导出目录就可以看到pkcs8格式的私钥，改后缀名为pem即可使用。

微信官方支付注册说明

1、微信支付申请地址：https://pay.weixin.qq.com/
2、微信公众号注册地址：https://mp.weixin.qq.com/ ，需注册服务号，并且完成实名认证。如果没有已认证的服务号或小程序，无法发起微信支付！
3、微信支付商户号与公众号、小程序关联绑定方法：https://pay.weixin.qq.com/static/pay_setting/appid_protocol.shtml

微信官方支付v2密钥配置说明
1、APIv2密钥设置方法：https://kf.qq.com/faq/180830UVRZR7180830Ij6ZZz.html
2、如果需要用到退款功能，还需要上传商户API证书：https://kf.qq.com/faq/161222NneAJf161222U7fARv.html

微信官方支付v3密钥配置说明
1、APIv3密钥设置方法：https://kf.qq.com/faq/180830E36vyQ180830AZFZvu.html
2、商户API证书、商户API证书序列号获取方法：https://kf.qq.com/faq/161222NneAJf161222U7fARv.html
将生成的商户API私钥“apiclient_key.pem”上传到网站指定目录下。
3、若未申请微信支付公钥，则微信支付公钥ID须留空。否则需要填写微信支付公钥ID，并下载微信支付平台公钥“pub_key.pem”上传到网站指定目录下。

企业付款

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

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

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

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

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