概述
VibeFox Peach Payments Pay Gateway 为 PrestaShop 添加 Peach Payments 银行卡付款功能。它连接到 Peach Payments Card API（COPYandPAY）。在付款步骤中，顾客选择银行卡付款，并在您商店付款页面上的 Peach Payments 付款表单中输入银行卡信息。银行卡数据在 Peach Payments 表单中输入，绝不会到达您的服务器。支持 Visa、Mastercard、American Express 和 Diners Club。订单只会在 Peach Payments 确认付款后才创建，因此中途放弃的付款不会留下未付款订单。
本模块适合位于南非、肯尼亚和毛里求斯、以 ZAR、KES 或 MUR 销售且拥有 Peach Payments 账户的商店。不支持从 PrestaShop 订单页面退款（请在 Peach Payments 控制面板中退款），也不支持保存银行卡、订阅、预授权和扣款，以及 EFT、BNPL、QR 或其他非银行卡付款方式。
主要功能
仅在 Peach Payments 确认后才标记为已付款：浏览器重定向本身绝不会创建已付款订单。顾客返回时，商店通过服务器间通信，从 Peach Payments API 读取此购物车的结账结果。
加密 Webhook：即使顾客在返回前关闭浏览器，Peach Payments Card Webhook（AES-256-GCM）也能确认付款。如果购物车正忙，Webhook 会收到临时错误响应，Peach Payments 将重新发送。
核对金额和货币：每笔付款都会与购物车核对。不一致时，订单会切换为 Peach Payments payment on hold 状态并添加备注，而不是标记为已付款。
避免重复处理：重复的 Webhook、页面刷新，或与顾客返回同时到达的 Webhook，绝不会创建第二个订单，也不会重复记录付款。对已付款订单的第二笔付款会被标记为需要退款。
测试和正式模式：Peach Payments 沙盒和正式账户分别使用独立的 Entity ID、Access Token 和 Webhook 密钥。付款始终在发起时所用的模式下核验。
控制面板操作记为备注：Webhook 会将 Peach Payments 控制面板中的退款、撤销和拒付添加到订单备注中。
银行卡品牌：选择付款表单显示的品牌。表单脚本使用 Subresource Integrity 哈希加载。
订单页面上的 Peach Payments 模块：付款 ID、结账 ID、金额、结果以及模块备注。可选的日志不含银行卡数据、密钥或顾客数据。
系统要求
PrestaShop 8.0 至 9.x，PHP 8.0 或更高版本并启用 OpenSSL 扩展。需要持有 Card API Entity ID 和 Access Token（测试和/或正式）的 Peach Payments 账户，以及 Peach Payments 提供的 Webhook 解密密钥以使用 Webhook。购物车货币：ZAR、KES 或 MUR。还需要来自 vibefox.net 的 VibeFox 许可证密钥（每个密钥对应一个域名）。