做跨境业务或者独立站收款时，只支持支付宝、微信、PayPal 或本地钱包往往还不够。很多海外用户更习惯直接使用银行卡付款，尤其是 Visa、Mastercard 这类国际卡组织。
对于面向海外用户的网站来说，开通 Visa / Mastercard 信用卡和借记卡收款，可以明显提升支付覆盖范围。本文以“彩虹易支付 + Antom 卡支付插件”为例，演示如何在现有易支付系统中增加 Antom Visa、Mastercard 银行卡收款通道。
本文主要演示：
- 彩虹易支付安装 Antom 卡支付插件
- 后台添加 Visa / Mastercard 支付方式
- 新增 Antom 银行卡支付通道
- 配置 Client ID、公钥、私钥、汇率等参数
- 测试信用卡支付、3D Secure 验证和订单回调
需要注意：银行卡支付涉及风控、拒付、3DS 验证和合规要求，建议使用 Antom 官方托管收银台或跳转页面完成卡信息收集，不建议自己在网站保存用户银行卡号、CVV 等敏感信息。
一、准备工作
开始之前，需要准备：
-
一套可正常运行的彩虹易支付系统,如果没有可以到https://www.wxcydz.cc/t-2893-1-1.html 购买下载。
支付方式、支付通道、订单创建、异步回调、同步跳转等基础功能需要正常。 -
Antom 商户账号
需要在 Antom 后台开通银行卡收款能力，至少包括：- Visa
- Mastercard
- Card / Bank Card / Antom Card 相关产品
-
Antom 接口参数
插件一般需要填写：- Client ID
- Antom 公钥
- 商户私钥
- 支付环境，测试环境或正式环境
- 交易汇率
-
网站 HTTPS 环境
银行卡支付对安全要求更高，网站建议必须使用 HTTPS，否则可能影响跳转、回调和支付成功率。
二、安装 Antom 银行卡支付插件
将 Antom 卡支付插件上传到彩虹易支付网站插件目录，然后解压。如果没有可以到https://www.wxcydz.cc/t-2893-1-1.html 购买下载。
上传完成后，进入彩虹易支付后台：
支付插件 -> 刷新插件列表
正常情况下可以看到类似插件：
antomcard / Antom银行卡支付
或者：
antom / Antom信用卡支付
具体插件名称以你实际插件显示为准。
如果刷新后没有出现插件，可以检查：
- 插件目录是否上传到正确位置
- 插件文件权限是否正常
- 插件配置文件是否完整
- PHP 版本是否兼容
- 是否缺少 curl、openssl 等扩展
三、添加支付图标
为了前台显示更清楚，可以在：
/assets/icon/
目录中放入银行卡支付图标，例如：
- visa.ico
- mastercard.ico
- card.ico
如果插件压缩包里已经自带图标，默认可以不用修改。
建议前台显示名称不要太长，可以使用：
- Visa
- Mastercard
- 银行卡
- 信用卡
如果想让用户更容易理解，也可以显示成：
- Visa / Mastercard
- 国际银行卡
- 信用卡支付
四、添加支付方式
进入彩虹易支付后台：
支付方式 -> 新增
可以根据插件支持方式选择两种配置方案。
方案一：添加一个统一银行卡支付方式
显示名称：
Visa / Mastercard
调用值：
bank
这种方式最简单，前台只显示一个“Visa / Mastercard”入口。用户进入 Antom 收银台后，再选择或填写自己的银行卡信息。
推荐大多数站点使用这种方式。
方案二：分别添加 Visa 和 Mastercard
如果你的插件支持分别指定卡品牌，也可以添加两个支付方式：
显示名称：Visa
调用值：visa
显示名称：Mastercard
调用值：mastercard
这种方式适合你想在前台单独展示 Visa 和 Mastercard 的情况。
不过实际支付时，Antom 可能仍然会通过统一的卡支付能力处理，是否能强制指定卡品牌，需要看 Antom 后台产品和插件接口是否支持。
五、新增支付通道
进入：
支付通道 -> 新增通道
这里以统一银行卡支付方式为例。
Antom 银行卡通道
支付方式：Visa / Mastercard
支付插件：Antom银行卡支付
可用接口：Card / Visa Mastercard / Antom Card
交易汇率：根据你的结算币种填写
如果你的易支付订单金额是人民币，而 Antom 提交币种是英镑，可以填写英镑汇率。
例如：
交易汇率：9.80
含义是：
1 GBP ≈ 9.80 CNY
插件会把人民币订单金额换算成英镑提交给 Antom。
例如：
¥98.00 ÷ 9.80 = GBP 10.00
如果你的 Antom 商户支持直接提交人民币或其他币种，则需要按照插件实际逻辑填写。不同商户开通的币种不同，建议以 Antom 后台显示的可用币种为准。
六、填写 Antom 接口参数
进入刚刚新增的支付通道配置页面，填写 Antom 参数。
常见配置包括：
Client ID：填写 Antom 后台提供的 Client ID
Antom 公钥：填写 Antom 平台公钥
商户私钥：填写你自己生成并上传到 Antom 的商户私钥
支付环境：测试环境或正式环境
交易汇率：按实际币种填写
支付币种：例如 USD、HKD、SGD 等
这里最容易填错的是公钥和私钥。
一般来说：
- Antom 公钥用于验证 Antom 返回的数据
- 商户私钥用于请求 Antom 接口时签名
- 不要把商户私钥和 Antom 公钥填反
- 正式环境和测试环境的参数不要混用
如果支付请求一直签名失败，优先检查密钥、Client ID、环境地址是否对应。
七、银行卡支付和 3D Secure 说明
Visa / Mastercard 和本地钱包不太一样。
本地钱包通常是扫码、App 跳转或钱包页面确认；银行卡支付通常会涉及：
- 填写卡号
- 填写有效期
- 填写 CVV
- 持卡人姓名
- 账单地址
- 3D Secure 验证
- 银行风控审核
- 支付成功或失败回调
建议插件使用 Antom 托管页面或 Antom 返回的跳转链接来完成卡信息收集。
这样有几个好处：
- 网站不用直接处理银行卡敏感信息
- 降低 PCI 合规压力
- 支持 3DS 验证跳转
- 支付失败、验证中、支付成功等状态更容易统一处理
Antom 官方文档中也提到，银行卡支付可能会返回需要跳转验证的链接，尤其是 3DS 场景下，用户需要跳转到发卡行或验证页面完成身份验证。
所以银行卡支付不能只看“是否立刻成功”，还要处理“处理中 / 等待验证 / 支付失败”等状态。
八、测试支付与回调
配置完成后，建议先使用测试环境或小金额正式环境测试。
测试流程：
- 新建一笔测试订单
- 选择 Visa / Mastercard 支付方式
- 跳转到 Antom 银行卡支付页面
- 填写测试卡或真实银行卡
- 如有 3DS 验证，按页面提示完成验证
- 支付完成后返回网站
- 查看彩虹易支付后台订单状态
- 确认订单是否自动变成已支付
如果支付成功但订单没有变成已支付，需要重点检查：
- Antom 是否正常发起异步通知
- notify 回调地址是否能公网访问
- 网站是否开启 HTTPS
- Antom 公钥是否填写正确
- 商户私钥是否填写正确
- 订单金额和币种是否一致
- 汇率换算后金额是否和回调金额匹配
- 服务器是否拦截了 Antom 回调请求
银行卡支付建议一定要以异步回调为准，不要只依赖用户浏览器同步跳转。
因为用户支付成功后，可能直接关闭页面，或者 3DS 验证后没有正常跳回网站。如果只靠同步跳转，订单状态可能无法正确更新。
九、常见问题
1. Visa / Mastercard 支付为什么不是直接成功？
银行卡支付经常会经过银行风控和 3DS 验证。
有些订单会立即成功，有些订单会进入处理中，还有一些订单需要用户跳转到发卡行页面完成验证。
所以插件需要正确处理 Antom 返回的支付状态和异步通知。
2. 为什么支付页面要求 3D Secure 验证？
3D Secure 是银行卡支付常见的安全验证方式，通常由发卡行触发。
用户可能需要输入短信验证码、银行 App 确认，或者完成其他身份验证。
这是正常流程，不代表插件配置错误。
3. 支付成功后易支付订单没有回调怎么办？
优先检查：
- 回调地址是否正确
- 服务器是否能被 Antom 访问
- SSL 证书是否正常
- 公钥私钥是否填反
- 插件是否正确验签
- 回调金额和订单金额是否因为汇率产生误差
建议后台保留完整的 Antom 回调日志，方便排查。
4. 为什么有些银行卡支付失败？
常见原因包括：
- 发卡行拒绝交易
- 银行卡不支持跨境支付
- 余额不足
- CVV 或有效期填写错误
- 3DS 验证失败
- 商户行业被风控
- 订单金额过高或过低
- Antom 后台没有开通对应卡组织或币种
银行卡支付失败不一定是插件问题，也可能是发卡行或风控策略导致。
5. 是否可以自己在网站收集银行卡号？
不建议。
银行卡号、CVV、有效期属于敏感支付信息。如果自己收集和保存，会涉及更高的 PCI 合规要求。
普通网站建议使用 Antom 托管收银台、跳转支付页面或官方提供的安全组件完成卡信息收集。
十、正式上线建议
正式上线前，建议检查：
- Antom 正式环境参数是否填写正确
- 测试环境参数是否已经切换为正式环境
- 网站是否全站 HTTPS
- 回调地址是否公网可访问
- 支付成功、失败、取消、处理中状态是否都能正常处理
- 订单日志是否完整
- 汇率是否合理
- 最小支付金额是否符合 Antom 要求
- 前台支付名称和图标是否清晰
银行卡支付还要特别注意拒付风险。建议网站保留订单信息、用户邮箱、IP、商品交付记录等资料，后续如果遇到争议或拒付，可以提供证明材料。
总结
通过 Antom 银行卡支付插件，彩虹易支付可以扩展支持：
- Visa
- Mastercard
- 国际信用卡
- 国际借记卡
相比本地钱包，银行卡支付覆盖范围更广，更适合面向欧美、东南亚、香港、新加坡等海外用户的独立站或数字产品网站。
推荐配置方式是：
- 前台使用“Visa / Mastercard”统一支付入口
- 插件通过 Antom 托管页面收集银行卡信息
- 手机端和电脑端统一跳转 Antom 支付页面
- 支付结果以 Antom 异步回调为准
- 易支付后台按回调结果自动更新订单状态
- 汇率按照实际提交币种正确换算
这样既能让用户用银行卡完成付款，也能减少网站直接处理银行卡敏感信息带来的合规压力。
