USA ePay for WooCommerce 信用卡支付网关介绍
USA ePay for WooCommerce 面向拥有 USA ePay 商户账户、希望在 WooCommerce 结账页直接接受信用卡付款的商家。与跳转到第三方支付页面的方式不同，这种集成让顾客在商城内完成支付流程，商家也可以在 WooCommerce 订单后台处理捕获、退款和撤销授权。它还支持保存支付令牌，并可与订阅和预售流程配合，适合需要重复扣款或延后扣款的业务。
先确认商户账户和服务器条件
安装插件之前，必须先拥有有效的 USA ePay 商户账户，并从 Merchant Console 获取 API Key 和 PIN。官方文档还列出 PHP、WordPress、WooCommerce 和 SSL/TLS 环境要求。支付网关并不是安装后自动开通的收款账户；商户是否能接受某些卡组织、是否支持订阅扣款和退款，仍取决于 USA ePay 账户配置及服务协议。
当前产品说明支持 Visa、Mastercard 等主要卡种，其他卡种应以商户账户实际启用情况为准。由于该集成涉及站内支付表单，商家还应确认自身 PCI DSS 合规范围，并向支付服务商或合规顾问确认适用的安全评估要求。不要在 WordPress 自定义代码、日志或邮件中保存完整卡号和安全码。
支付网关能处理哪些订单动作
- 信用卡支付：顾客在 WooCommerce 结账时输入卡片信息，支付由 USA ePay 处理。
- 保存支付方式：顾客可以在结账或账户页面保存支付令牌，便于后续重复付款。
- 预授权和捕获：商家可先授权交易，再在发货或服务确认后捕获资金。
- 退款与撤销：可从订单后台发起全额或部分退款，以及撤销尚未捕获的授权。
- 订阅与预售：可用于周期续费或预售商品在指定时间进行后续扣款，前提是账户和扩展配置支持。
推荐的安装与测试流程
- 在测试站安装插件，确认 SSL/TLS 正常，网站使用的支付页面没有被缓存或脚本优化破坏。
- 进入 WooCommerce 的 USA ePay 设置页，填写测试环境 API Key 和 PIN，先启用 Sandbox/Test 模式。
- 按官方文档配置支付标题、描述、授权与自动捕获规则，以及是否允许顾客保存卡片。
- 使用测试卡或服务商提供的测试凭据，分别模拟成功、拒绝、取消、退款和预授权捕获。
- 如果销售订阅或预售商品，单独测试首次付款、续费、修改付款方式和预售释放时的扣款。
- 测试通过后再切换正式环境凭据，并用小额交易核对资金结算和订单状态。
为什么要把授权和捕获分开理解
有些业务在顾客下单时先确认额度，等商品发货或服务实际提供后才捕获资金。若插件启用了自动捕获，订单状态变更可能触发实际扣款；如果业务需要先授权再确认，应明确设置规则并让仓库、客服和财务知道何时捕获。对于虚拟商品，商家可能希望付款后立即完成；对于预售和定制商品，则可能需要延后处理。不同商品不一定适用相同的支付策略。
保存支付方式也需要顾客明确授权。令牌化减少了商家直接保存卡号的需求，但并不意味着可以绕过隐私和支付合规要求。客户更换银行卡时，通常需要删除旧令牌并重新添加新的支付方式，不能假设插件可以直接修改第三方保存的卡片信息。
与其他网关和订阅工具搭配
若商城需要更灵活的自定义付款字段或特殊线下付款方式，可对照本站的 WooCommerce Custom Payment Gateway，但它本身不是收单机构；如果业务需要周期扣款和会员续费，应结合 WooCommerce Subscriptions 规划订阅周期、失败重试和取消规则。网关负责处理付款，订阅扩展负责管理周期订单，两者必须共同测试。
常见问题
为什么顾客无法完成信用卡付款？
检查商户账户状态、API Key/PIN、SSL/TLS、卡组织开通情况和支付网关日志。
能否保存顾客信用卡完整信息？
不应由商家自行保存完整卡号和安全码。应使用支付服务商提供的令牌化机制，并按要求处理支付数据。
测试环境的付款会扣真实资金吗？
官方文档提供独立 Sandbox 环境，应使用测试凭据验证流程，避免误用正式 API Key。
下载旧资源时的安全检查
官方资料参考：USA ePay 官方文档。实际安装前应以当前产品页面、维护状态和站点环境要求为准。
原始资源记录对应较早的 USA ePay 文件，当前官方扩展的支付和订阅能力可能已有变化。下载破解版或 nulled 文件后，应先在隔离测试站验证 API 连接、退款、令牌和订阅流程。支付插件属于高风险组件，未经检查的文件不应接触真实客户卡片或商户密钥。
