前言
做跨境独立站、发卡站、充值站、SaaS 服务,最头疼的一件事就是:同时搞定国内用户和海外用户的收款。国内要支付宝、微信、银联卡;海外要 Visa/Mastercard、各种本地钱包和网银,还得支持多币种结算。
WooshPay 是一家总部在伦敦的支付服务商,提供统一支付网关和多币种结算能力,支持全球 120+ 货币以及包括信用卡 / 借记卡、电子钱包(如 Alipay、WeChat Pay 等)、本地网银和实时支付方式等多种收款渠道。
本文就以彩虹易支付 + WooshPay 支付插件为例,演示如何在你现有的易支付平台中,对接 WooshPay 收款,打通:
-
国内常用:支付宝、微信支付、银联卡(UnionPay Cards)以此插件为例讲解
-
国际卡:Visa / Mastercard / American Express / JCB 等主流信用卡 / 借记卡
-
多种本地支付:iDEAL、Giropay、Bancontact、SEPA、Sofort、TrueMoney、UPI 等(可按你实际开通情况启用)
如果你已经在用彩虹易支付做聚合支付,只要增加一个 WooshPay 插件和对应通道,就能“原地升级”为全球收款中心。
一、准备工作
在动手对接之前,建议先准备好以下内容:
-
一套可正常使用的彩虹易支付程序,没有新版易支付和插件的到这个地址:https://www.wxcydz.cc/t-2893-1-1.html 下载。,购买下载插件后在易支付网站根目录解压文件。
-
PHP 环境、数据库已配置完成
-
商户、支付方式、支付通道等功能正常
-
-
WooshPay 商户账号
-
在 WooshPay 官网申请商户(需要公司/主体资料)
-
完成必要的 KYC/KYB 审核
-
后台可以看到 API Key / Secret / Webhook URL 配置等信息
-
-
WooshPay 支付插件文件(适配彩虹易支付)没有插件的到这个地址:https://www.wxcydz.cc/t-2893-1-1.html 购买。
-
将插件打包好的 php 文件 + 配置文件 + 图标 下载到本地
-
插件目录通常会包含类似:
-
核心逻辑
-
配置示例、说明文档
-
插件的具体文件名和路径,请以你自己的版本为准,下面只是示例写法,方便你在文章里替换。
二、安装彩虹易支付 WooshPay 插件
1. 上传插件文件
-
使用 SFTP / 宝塔面板 / 文件管理 等方式,进入你的网站根目录,比如:
-
找到彩虹易支付程序的根目录,一般会有:
-
/includes/ -
/pay/ -
/assets/icon/ -
等文件夹
-
-
将插件压缩包上传到易支付网站根目录后解压:
-
如果插件已经打包好目录结构,解压后会自动将文件放到正确位置
-
如果是散文件,需要按插件说明手动放置到相应目录
-
2. 添加支付图标(可选)
为了在易支付后台和前端显示更美观,你可以:
-
将 WooshPay 主图标命名为:wooshpay.ico
-
如果区分通道,例如:
-
支付宝(WooshPay):alipay.ico
-
微信(WooshPay):wechat.ico
-
银联 Cards(WooshPay):unionpay.ico
-
然后统一放到彩虹易支付的图标目录,例如:
3. 刷新插件列表
登录彩虹易支付后台(管理员账户):
-
进入 “支付插件” 或类似菜单
-
点击 刷新插件 / 更新缓存(不同版本名字略有区别)
-
你应该可以看到类似:
WooshPay 全球支付收款插件
WooshPay – Alipay / WeChat / Cards
如果已经能看到说明文字,说明插件安装部分基本成功。
三、在 WooshPay 后台获取必要参数
具体字段名以插件说明为准,我们插件需要的参数为下面的信息
通常需要在 WooshPay 商户后台 获取以下信息:
-
Merchant ID / Client ID / Account ID
-
API Key / Secret Key
-
回调通知地址(Webhook / Notify URL)
一般步骤:
-
登录 WooshPay 商户后台
-
找到类似
Developers / API / Keys的菜单
-
创建一套 API 凭证(如果还没创建)
-
将生成的 ID / Key / 密钥等信息保存好,后面要填到易支付后台
建议先在 测试(Test/Sandbox)环境 完成对接,确认无误再切到正式(Live)环境。
四、在彩虹易支付后台新增支付方式
让易支付“认识” WooshPay 这个网关,通常要先新增几个独立的支付方式(也就是前台看到的“支付通道名称”)。
以下以三种典型方式为例:
-
Alipay(国内/跨境支付宝),一般默认都有
-
WeChat(微信支付),一般默认都有
- UnionPay银联支付,一般默认都有
-
WooshPay_Cards(Visa/Master/Amex/JCB)
在后台操作步骤类似:
-
登录易支付后台
-
找到 “支付方式管理”(或类似菜单)
-
点击 新增支付方式,按以下示例填写:
示例一:支付宝(WooshPay)
-
显示名称:支付宝
-
调用值(英文标识):alipay
-
支持设备:PC + Mobile
示例二:微信支付(WooshPay)
-
显示名称:微信支付
-
调用值:wxpay
-
支持设备:PC + Mobile
示例三:卡支付 / 银联 Cards(WooshPay)
-
显示名称:银行卡 / Cards(WooshPay)
-
调用值:wooshpay_cards
-
支持设备:PC + Mobile
-
支付图标:unionpay_wooshpay.ico 或卡片图标
注意:调用值 要和插件内部定义的代码保持一致,插件会根据这个值判断调用哪一种 WooshPay 支付方式。
五、在彩虹易支付新增 WooshPay 支付通道
支付方式只是“壳子”,真正决定能否收款的是支付通道。
1. 新增通道(以支付宝为例)
在易支付后台:
-
进入 支付接口 / 支付通道管理
-
点击 新增支付通道
-
参考如下配置:
-
通道名称:支付宝
-
分成比例:根据你的业务需求自行设置
-
通道模式:按你的易支付版本说明选择(不会就先默认)
-
支付方式:支付宝
-
支付插件:选择 WooshaliPay (插件安装后出现的名称)
-
状态:启用
在下方的插件配置区域,填入第四步中从 WooshPay 后台拿到的参数,例如:
-
Merchant / Client ID
-
API Key / Secret Key
-
公钥 / 私钥
-
支持货币(默认CNY / USD / EUR 等)
2. 新增微信、Cards 通道
步骤与支付宝类似,只是:
-
支付方式 换成对应的微信支付(WooshPay)、银行卡 / Cards(WooshPay)
-
如果插件支持在同一个通道里多种支付方式,你也可以一个通道搞定多个方式
六、货币与结算设置(多币种收款)
WooshPay 支持在全球 34+ 国家和地区开展业务,并支持 120+ 种货币收款,适合做多币种结算。
1. 易支付中的货币字段
大多数彩虹易支付插件在发起支付时,会有一个货币代码(如CNY/USD)传给网关。 WooshPay 插件也是这样设计的,你可以:
-
在插件文件中设置默认收款币种,例如:
-
CNY:适合面向国内用户
-
USD /EUR:适合跨境、欧美用户
-
-
或者在插件配置中做成可选项,你就可以在后台选择收款币种
2. 收款币种与结算策略
常见做法有两种:
-
所有订单统一结算为某个币种(比如 USD)
-
前端显示人民币/本地价格
-
实际结算到 WooshPay 账户为 USD
-
-
按地区/站点使用不同币种
-
国内站点用 CNY
-
海外站点用 USD / EUR / GBP
-
根据自己公司主体和 WooshPay 开通的结算币种来决定。
七、测试支付与回调
配置完成后,我们做 完整闭环测试:
-
使用一个小金额订单,分别测试:
-
支付宝(WooshPay)
-
微信(WooshPay)
-
Cards / 银联卡
-
-
在 WooshPay 后台查看:
-
是否生成对应订单
-
交易状态是否为成功(Paid / Succeeded 等)
-
-
在易支付后台查看:
-
订单状态是否能够自动从“未支付”变为“已支付”
-
回调日志是否没有报错
-
如果发现:
-
WooshPay 成功,易支付未回调成功 → 检查回调 URL、签名参数
-
易支付显示成功,但 WooshPay 订单未真正扣款 → 检查是否误用了测试环境或重复请求
对于彩虹易支付来说,最关键的就是 回调签名验证 一定要写对,否则订单会“卡在半路”。我们测试后完美回调
八、常见问题(FAQ)
1. WooshPay 是否支持高风险行业?
WooshPay 官方定位是全球跨境支付服务商,支持多种行业和地区,具体能否开通、费率如何,要以你提交的业务资料和实际审核结果为准。
2. 能同时开通多少种支付方式?
从 WooshPay 官方资料来看,它支持多种卡支付、钱包支付、本地银行转账和实时支付方式,常见的有:
-
Alipay、WeChat Pay
-
Visa、Mastercard、American Express、JCB 等
-
iDEAL、Giropay、Bancontact、SEPA、Sofort 等本地方式
能具体开通哪些,取决于你的公司所在地、业务类型、风险等级。
3. 彩虹易支付老版本能用这个插件吗?
原则上,只要:
-
支持自定义支付插件
-
支持新增支付方式和支付通道
-
PHP 版本满足插件最低要求
就可以通过本教程的思路接 WooshPay。部分非常老的版本可能需要你手工改一点代码或兼容一下命名空间。
4. 手续费大概是多少?
WooshPay 不同支付方式、不同地区的费率会不一样,比如卡支付、钱包支付、虚拟卡发卡等都有不同价目。具体可以在其官网的定价页面或商务对接时获取详细费率表。
总结
通过彩虹易支付 + WooshPay 支付插件的组合,你可以在不大改现有网站支付架构的前提下,快速获得:
-
支付宝、微信、银联 Cards 等国内主流收款能力
-
Visa / Mastercard / Amex / JCB 等全球信用卡收款能力
-
多种本地支付方式(iDEAL、Giropay、Bancontact、UPI 等),更贴近目标市场用户习惯
-
多币种收款和结算能力,让你的业务真正走向全球
如果你本身已经在用彩虹易支付跑国内业务,只需要多装一个 WooshPay 插件、建立几条支付通道,就可以从“只做国内收款”升级为“全球收款平台”。









