概述
VibeFox Hubtel Pay Gateway 为 PrestaShop 添加在加纳通过 Hubtel 付款的功能。在付款步骤，顾客选择 Hubtel 后会被重定向至安全的 Hubtel Online Checkout 页面，使用 MTN MoMo、Telecel Cash、AirtelTigo Money、Visa 或 Mastercard 银行卡或 GhQR 完成付款，然后返回您的商店。只有在 Hubtel 确认付款后才会创建订单，因此中途放弃的付款不会留下未付款订单。
本模块适合以加纳塞地（GHS）结算并拥有 Hubtel 商业账户的加纳商店。Hubtel 必须将您 Web 服务器的 IP 地址加入其 Transaction Status API 的白名单；此外 Hubtel 没有公开的测试环境，因此所有付款均为真实交易。本模块不支持通过 PrestaShop 退款、不支持订阅、不保存银行卡，也不支持在商店内选择支付通道。
主要功能
Hubtel 托管付款页面：在 Hubtel 页面上使用 Mobile Money 和银行卡付款。顾客在页面上直接选择支付通道。
仅在 Hubtel 确认后才标记为已付款：Hubtel 回调未签名，因此模块绝不信任回调。模块会向经身份验证的 Hubtel Transaction Status API 发起查询，仅当 Hubtel 报告该付款为 "Paid" 且金额与 GHS 购物车总额完全一致时，才以已付款状态创建订单。
金额核对：金额不符时，订单将进入 Hubtel payment on hold 状态，并为商店管理员添加备注。
Hubtel 端无需任何设置：回调 URL 会随每笔付款一同发送。
应对丢失的回调：顾客返回时会核查付款，cron URL 会运行后台复核，商店管理员还可以在订单页面点击 Check Hubtel payment status。
杜绝重复处理：每次付款尝试都有独立的参考编号。重复的回调绝不会再创建第二个订单，也不会重新开启已取消或已退款的订单。对已付款购物车的二次付款会被标记为待退款。
在 Hubtel 取消：顾客会带着提示返回结账页面，可重新尝试付款。购物车将被保留。
订单页面中的 Hubtel 模块：显示订单的所有付款尝试及其在 Hubtel 的状态和交易，并列出 Hubtel 备注。可选日志不包含 API 密钥或顾客数据。
系统要求
PrestaShop 8.0 至 9.x，PHP 8.0 或更高版本并启用 cURL 扩展。需要拥有包含 API ID、API Key 和商户账号（POS Sales ID）的 Hubtel 商业账户，且您的服务器 IP 已被 Hubtel 加入白名单。商店货币须为加纳塞地（GHS）。建议在服务器上设置 cron 以进行后台检查。需要来自 vibefox.net 的 VibeFox 许可证密钥（每个域名一个密钥）。