概述
VibeFox HyperPay Payment Gateway 通过 HyperPay 的 COPYandPAY 小部件为 PrestaShop 添加银行卡付款功能。顾客在结账中确认订单后，会在您商店的付款页面看到 HyperPay 付款小部件，并可在该页面使用 VISA、Mastercard、mada、American Express、STC Pay 或 Apple Pay 付款。银行卡信息仅在 HyperPay 小部件中输入，绝不会到达您的服务器。订单仅在 HyperPay 确认付款后才会创建，因此被放弃或被拒绝的付款不会产生未付款订单。
本模块适合在沙特阿拉伯、阿拉伯联合酋长国、约旦、巴林、阿曼、卡塔尔、埃及以及其他中东和北非（MENA）市场拥有 HyperPay 商户账户的店铺。本模块不支持通过 PrestaShop 进行退款或撤销（请在 HyperPay 控制面板中操作）、保存银行卡、订阅、Apple Pay 域名验证、按品牌分别使用独立 Entity ID，也不支持先买后付（buy-now-pay-later）方式。
主要功能
HyperPay 小部件：COPYandPAY 小部件位于付款页面，通过 Subresource Integrity 加载；在 HyperPay 支持的情况下，使用顾客的语言。您可以选择显示哪些品牌。
仅在 HyperPay 确认后才标记为已付款：顾客返回时通过服务器对服务器的状态查询确认，浏览器关闭时通过加密 Webhook（AES-256-GCM）确认。仅凭返回网址绝不会创建已付款订单。
与购物车核对：付款必须属于该购物车自身的某个 HyperPay 付款会话，且金额和币种必须与购物车一致。若不一致，订单将置于 HyperPay payment on hold 状态并附带备注。
避免重复处理：每个结果只应用一次。重复的 Webhook 或页面刷新绝不会创建第二个订单。重复付款、取消后的付款以及冲正（reversal）均会记录在订单中。
即时扣款或预授权：立即扣款，或预留金额并稍后在订单的 HyperPay 区块中通过 Capture payment 进行扣款。
测试与正式：每种模式各有独立的 Access Token、Entity ID 和 Webhook 密钥。状态查询、扣款和 Webhook 始终使用创建付款会话时所用的模式。
清晰的提示：被拒绝、未完成或尚未确认的付款会在结账页面向顾客说明，购物车会保留以便再次尝试。
订单页面的 HyperPay 区块：付款 ID、付款会话、金额、结果以及扣款按钮。日志不包含银行卡数据、密钥或顾客数据。
系统要求
PrestaShop 8.0 至 9.x，PHP 8.0 或更高版本并启用 OpenSSL 扩展。需要一个 HyperPay 商户账户，持有 Access Token 和 Entity ID（测试和正式），以及一个带解密密钥的付款 Webhook。还需要一个来自 vibefox.net 的 VibeFox 许可证密钥（每个域名一个密钥）。