概述
VibeFox Helcim Gateway 通过 Helcim Payment API 为 PrestaShop 添加信用卡付款功能。顾客在您的结账页面的付款步骤中输入银行卡信息，您的服务器将其发送到 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 控制面板中执行的扣款、退款和撤销不会同步到 PrestaShop。
主要功能
结账页面上的银行卡表单：卡号、有效期、CVC 和持卡人姓名，在发送前进行验证（卡号校验和、有效期未过期、CVC 位数），并带有银行卡品牌图标。
购买或预授权：立即对银行卡扣款，或仅冻结资金并在稍后通过订单中 Helcim 模块里的 Capture payment 进行扣款。
仅在 Helcim 批准后创建订单：仅在 Helcim 批准交易后才会创建订单。被拒绝的银行卡不会生成订单。若批准的金额或币种与购物车不一致，订单将进入 Helcim payment on hold 状态并附带备注。
每个购物车仅扣款一次：并行提交会被锁定，已付款的购物车绝不会被再次扣款，并且每次尝试均使用幂等性密钥。因此超时后的重试将返回 Helcim 的原始结果，而不会对银行卡进行二次扣款。
在订单页面退款：可在订单中的 Helcim 模块区块里进行全额和部分退款，退款金额不超过 Helcim 实际扣款的金额。对未扣款的预授权进行全额退款将解除预授权冻结。
正式与测试令牌：分别为您的 Helcim 正式和测试账户提供独立的 API 令牌。扣款和退款始终使用支付该订单时所用的账户。
订单页面中的 Helcim 区块：交易 ID、银行卡类型及末 4 位数字、批准金额、退款记录以及模块备注。错误日志不记录卡号、CVC、令牌或个人数据。
系统要求
PrestaShop 8.0 至 9.x，PHP 8.0 或更高版本。需要一个 Helcim 商户账户（加拿大或美国）和一个 API 令牌。店铺需启用 HTTPS 并配备符合 PCI DSS 规范的主机托管。需要 vibefox.net 提供的 VibeFox 许可证密钥（每个域名一个密钥）。