随着跨境业务的发展，越来越多的网站开始面向海外用户提供数字产品、软件服务、会员服务等。
传统的支付宝、微信支付主要面向国内用户，而海外客户更习惯使用 Visa、Mastercard 等国际银行卡进行付款。
如果你的网站使用易支付系统，通过接入 WooshPay 银行卡支付插件，可以快速增加国际信用卡付款方式，让海外用户直接使用银行卡完成支付。
本文以 易支付 + WooshCard 银行卡支付插件 为例，详细介绍如何配置 WooshPay Card 支付通道，实现 Visa / Mastercard 银行卡收款。
本文主要演示：
- 易支付安装 WooshCard 插件
- 后台添加银行卡支付方式
- 配置 WooshPay 商户参数
- 设置支付环境
- 测试银行卡付款流程
- 检查异步回调
- 常见问题处理
目录
- 一、准备工作
- 二、安装 WooshCard 银行卡支付插件
- 三、添加银行卡支付方式
- 四、配置 WooshPay 接口参数
- 五、银行卡支付流程说明
- 六、测试 Visa / Mastercard 支付
- 七、订单回调检查
- 八、常见问题
- 总结
一、准备工作
开始配置之前，需要准备以下内容：
1. 正常运行的易支付系统
首先需要确保你的易支付系统可以正常运行。如果没有，可以到易支付源码及插件购买或下载。
包括：
- 网站访问正常
- 数据库连接正常
- 支付订单创建正常
- 异步通知功能正常
如果基础支付系统无法创建订单，银行卡插件也无法正常工作。
2. WooshPay 商户账号
需要提前注册 WooshPay 商户账号，并完成相关审核。
开通银行卡支付能力后，可以获得接口参数。
WooshPay Card 支付方式使用：
payment_method_types:
card官方文档中银行卡支付支持 Card 通道，并提供 Checkout 和 API 两种接入方式。
3. WooshPay 接口参数
插件配置通常需要以下信息：
- Secret Key
- Publishable Key
- Webhook Secret
- 商户 ID（如果需要）
- 测试环境 / 正式环境
- 回调地址
这些参数需要从 WooshPay 商户后台获取。
4. 网站 HTTPS
由于银行卡支付涉及支付页面跳转和支付结果通知：
建议：
- 使用 HTTPS
- SSL 证书正常
- 域名可以正常访问
否则可能出现：
- 支付页面无法打开
- 支付成功但是订单未更新
- 回调失败
二、安装 WooshCard 银行卡支付插件
如果没有，可以到易支付源码及插件购买或下载。然后解压到插件目录。
然后进入易支付后台。
进入：
后台管理
↓
支付插件
↓
刷新插件列表WooshCard或者：
WooshPay Card插件名称根据版本可能有所不同。
如果没有显示插件，可以检查：
- 插件目录是否正确
- PHP版本是否符合要求
- 文件权限是否正常
- 插件文件是否完整
- PHP curl 扩展是否开启
三、添加银行卡支付方式（非必须)
进入：
易支付后台
支付管理
支付方式新增支付方式。我们默认的是card，就是易支付的网银支付，如果你要区分，就可以新增一个其它支付方式。
填写：
支付名称：
银行卡付款或者：
Visa / Mastercard支付图标建议使用：
card.ico或者：
visa-mastercard.ico
前台显示效果：
银行卡付款
Visa
Mastercard
信用卡 / 借记卡海外用户看到银行卡支付，会比中文名称更容易理解。
四、配置 WooshPay 接口参数
进入：
支付管理
支付通道
新增，名称随便填，支付方式：网银支付（默认）
WooshCard填写接口信息。
例如：
Secret Key
填写：
sk_xxxxxxxxxPublishable Key
填写：
pk_xxxxxxxxx
Webhook Secret
填写：
whsec_xxxxxxxxx
支付环境
如果测试：
选择：
Test正式营业：
选择：
Live测试完成后一定切换正式环境。
支付方式参数
银行卡支付方式：
填写：
card对应 WooshPay Card 支付接口。
五、银行卡付款流程说明
用户购买商品时：
第一步：
用户进入付款页面。
第二步：
选择：
银行卡付款第三步：
跳转到 WooshPay 收银台。
第四步：
用户输入：
- 银行卡号码
- 有效期
- CVV安全码
第五步：
支付完成。
第六步：
WooshPay 通知易支付服务器。
第七步：
订单自动变成：
支付成功整个流程无需人工确认。
六、测试 Visa / Mastercard 支付
配置完成后，需要测试支付。
测试步骤：
- 创建一个测试商品
例如：
金额：1美元- 使用测试环境付款
- 查看支付页面
- 检查订单状态
确认：
✅ 支付页面正常打开
✅ 银行卡输入正常
✅ 支付成功跳转正常
✅ 易支付订单自动完成
七、订单回调检查
如果出现：
付款成功，但是订单没有变化。
检查：
1. 回调地址
确认：
notify_url可以公网访问。
2. 防火墙
检查：
- Cloudflare规则
- Nginx限制
- WAF
3. PHP日志
查看：
runtime/log或者：
php error log确认是否收到 WooshPay 通知。
八、常见问题
1. WooshPay 支持哪些银行卡？
WooshPay Card 支付用于银行卡付款，用户可以通过支持的银行卡网络完成支付。具体支持品牌和地区以 WooshPay 商户后台和官方文档为准。
2. 为什么支付成功没有回调？
常见原因：
- 网站无法访问
- HTTPS异常
- 回调地址错误
- 防火墙拦截
3. 测试成功，正式环境失败？
检查：
- 是否切换 Live Key
- 是否开启正式支付权限
- 是否完成商户审核
4. 用户付款失败怎么办？
建议检查：
- 银行卡地区
- 卡类型
- 风控限制
- WooshPay后台交易记录
总结
通过 WooshCard 插件，可以让易支付系统增加国际银行卡付款能力。
对于销售：
- 软件
- VPS
- 数字产品
- 会员服务
- 海外服务
的网站来说，Visa / Mastercard 是非常重要的支付方式。
完成配置后，海外用户无需注册账号，可以直接使用银行卡完成付款，提高跨境交易成功率。
