概述
VibeFox Peach Payments Pay Gateway 通过 Peach Payments 的 COPYandPAY 表单为 OpenCart 3 和 OpenCart 4 添加银行卡付款功能。在最后一步结账时，顾客点击 Confirm Order，进入您店铺的付款页面，在 Peach Payments 表单中输入银行卡信息。银行卡数据绝不会到达您的服务器。OpenCart 会在付款前创建订单，但只有在 Peach Payments 确认付款后，订单才会获得状态，因此未付款的尝试会保持为缺失订单（missing orders）。
适用于南非、肯尼亚和毛里求斯的店铺，这些店铺以 ZAR、KES 或 MUR 销售，并拥有带 Card API 的 Peach Payments 账户。本扩展仅接受一次性银行卡付款。结账步骤本身没有银行卡表单，不支持保存银行卡、订阅、预授权与捕获，也不支持从 OpenCart 退款（退款在 Peach Payments 后台进行），且不支持 EFT、BNPL、QR 或其他非银行卡付款方式。
主要功能
Peach Payments 银行卡表单：根据设置显示 Visa、Mastercard、American Express 和 Diners Club。表单脚本使用 Subresource Integrity 哈希加载，并且在 Peach Payments 支持时，表单会跟随顾客的语言。
仅在 Peach Payments 确认后才付款成功：订单状态在顾客返回时通过服务器端状态查询设置，或在收到 Peach Payments 加密的 webhook 后设置。随后 OpenCart 发送其常规订单邮件。
加密的 webhook：webhook 使用您的 AES-256-GCM 密钥解密，因此只有 Peach Payments 可以更改您的订单。即使顾客关闭了浏览器，付款仍会被确认。
金额和货币检查：与订单不符的付款会进入带备注的审核状态。Peach Payments 标记为需人工审核的付款也会附带备注。
不会重复处理：返回操作和 webhook 都不会重复应用同一笔付款，即使 OpenCart 3 每次显示确认步骤都会创建新订单，而 OpenCart 4 会更新结账中的一个订单，同一购物车也不会被付款两次。
测试与正式模式：分别设置 Entity ID、访问令牌和 webhook 密钥。付款始终按其发起时所处的模式进行核对。
备注中记录后台退款：在 Peach Payments 中进行的退款、冲正和拒付，会通过 webhook 添加到订单备注中。
您自己的订单状态以及订单页面上的 Peach Payments 标签页：为已付款订单、待付款、审核中付款和付款失败分别选择 OpenCart 状态。提供地理区域、最低订单金额，以及不含银行卡数据、密钥或顾客数据的可选日志。
系统要求
OpenCart 3.0.x（已在 3.0.5.0 上测试）或 OpenCart 4.0.2 及更高版本（已在 4.1.0.3 上测试），PHP 8.0 或更高版本并启用 OpenSSL 扩展。一个下载包同时包含两个版本的安装包。店铺中需有 ZAR、KES 或 MUR 货币。一个带有 Card API Entity ID 和 Access Token（测试与正式）的 Peach Payments 账户，以及 Peach Payments 提供的 webhook 解密密钥。店铺必须可从互联网访问，才能接收 webhook。需要一个来自 vibefox.net 的 VibeFox 许可证密钥（每个域名一个密钥）。