概述
VibeFox Hubtel Pay Gateway 为 OpenCart 3 和 OpenCart 4 添加在加纳使用 Hubtel 的付款功能。顾客在最后一步结账时点击 Confirm Order，随后被引导至安全的 Hubtel Online Checkout 页面，可使用 MTN MoMo、Telecel Cash、AirtelTigo Money、Visa 或 Mastercard 银行卡，或 GhQR 付款，付款后返回您的店铺。OpenCart 会在付款前创建订单，但只有在 Hubtel 确认付款后订单才会获得状态，因此未付款的尝试会保留为缺失订单。
本扩展适合以加纳塞迪（GHS）销售、并拥有 Hubtel 商户账户的加纳店铺。您的网络服务器 IP 地址需要由 Hubtel 加入其 Transaction Status API 的白名单；Hubtel 没有公开的测试环境，因此所有付款均为真实交易。本扩展不支持从 OpenCart 发起退款，也不支持订阅、保存银行卡，以及在店铺内选择付款渠道。
主要功能
托管式 Hubtel 结账：在 Hubtel 页面上使用移动货币和银行卡付款。顾客在该页面选择付款渠道。
仅在 Hubtel 确认后才视为已付款：Hubtel 的回调未经签名，因此扩展从不信任它们。扩展会查询经过身份验证的 Hubtel Transaction Status API，只有当 Hubtel 报告该订单以 GHS 计价的完整订单金额为 Paid 时，才会将订单标记为已付款。之后 OpenCart 会发送其常规订单邮件。
金额核对：金额不一致时，订单会进入您选择的审核状态，并附带备注。
无需在 Hubtel 中进行设置：每笔付款都会附带回调 URL。
覆盖丢失的回调：顾客返回时会检查付款情况，后台的 cron URL 会定期重新检查，您也可以在订单页面点击 Check Hubtel payment status。
避免重复处理：每次付款尝试都有各自的参考编号。重复的回调不会将同一笔付款应用两次，也不会重新打开已取消的订单。在发起新的尝试之前，会向 Hubtel 核查同一购物车中之前未确认的尝试；对已付款订单的第二笔付款会被标记为需要退款。
订单页面中的 Hubtel 选项卡：显示该订单的所有付款尝试及其 Hubtel 状态和交易信息，以及 Hubtel 备注。
OpenCart 设置：地区、最低订单金额、排序，以及您自己的订单状态。可选日志不包含 API 密钥或顾客数据。
系统要求
OpenCart 3.0.x（已在 3.0.5.0 上测试）或 OpenCart 4.0.2 及更高版本（已在 4.1.0.3 上测试），PHP 8.0 或更高版本并启用 cURL 扩展。同一个下载包中包含两个版本的安装包。一个 Hubtel 商业账户，包含 API ID、API Key 和商户账号（POS Sales ID），并且您的服务器 IP 已被 Hubtel 加入白名单。订单币种为加纳塞迪（GHS）。建议使用服务器 cron 进行后台检查。从 vibefox.net 获取的 VibeFox 许可证密钥（每个域名一个密钥）。