概述
VibeFox Helcim Gateway 通过 Helcim Payment API 为 OpenCart 3 和 OpenCart 4 添加信用卡付款功能。顾客在最后一步结账时，在 Confirm Order 按钮上方的表单中输入银行卡信息，您的服务器将其发送至 Helcim，订单状态则根据同一请求中 Helcim 的响应确定。支持 Visa、Mastercard、American Express、Discover 和 UnionPay，币种为 CAD 或 USD。
本扩展适合在加拿大和美国、拥有 Helcim 账户并希望直接在结账页面显示银行卡表单的商家。银行卡信息会经过您的 Web 服务器，因此您的商店需要 HTTPS 以及符合 PCI DSS 标准的托管环境（SAQ D）。本扩展不支持保存的银行卡、订阅、ACH 或银行转账付款、Apple Pay、Google Pay 或 3-D Secure，也不支持 Helcim Webhook：在 Helcim 后台进行的扣款、退款和撤销不会同步到 OpenCart。
主要功能
结账页面的银行卡表单：卡号、有效期、CVC 和持卡人姓名，在发送前进行检查（卡号校验和、有效期未过期、CVC 长度）。
购买或预授权：立即扣款，或仅预留资金，之后可在订单选项卡中使用 Capture payment 进行扣款。
仅在批准后才有状态：OpenCart 会在付款前创建订单，但只有在 Helcim 批准交易后订单才会获得状态，因此被拒绝的银行卡只会留下一个缺失订单。如果批准的金额或币种与订单不符，订单将进入您的审核状态并附带备注。
每个购物车只扣一次款：并行提交会被锁定，已付款的购物车不会再次扣款，每次尝试都使用幂等密钥，因此超时后的重试会返回 Helcim 的原始结果，而不会对银行卡重复扣款。
从订单页面退款：在订单的 VibeFox Helcim Gateway 选项卡中进行全额和部分退款，金额以 Helcim 实际扣款的金额为上限。未扣款的预授权将被全额释放。
正式和测试令牌：为您的 Helcim 正式账户和测试账户分别设置 API 令牌。扣款和退款始终使用订单付款时所用的账户。
您自己的订单状态：为已付款订单、预授权、待审核订单、已释放的预授权以及全额退款选择 OpenCart 状态。地区、最低金额和排序与任何 OpenCart 付款方式相同。错误日志不包含卡号、CVC、令牌或个人数据。
系统要求
OpenCart 3.0.x（已在 3.0.5.0 上测试）或 OpenCart 4.0.2 及更高版本（已在 4.1.0.3 上测试），PHP 8.0 或更高版本。下载文件为一个压缩包，内含两个版本的安装包。一个 Helcim 商户账户（加拿大或美国）和一个 API 令牌。结账币种为 CAD 或 USD。商店需使用 HTTPS，并采用符合 PCI DSS 标准的托管环境。从 vibefox.net 获取的 VibeFox 许可证密钥（每个域名一个密钥）。