概述
VibeFox ifthenpay Gateway 为 PrestaShop 添加面向葡萄牙客户的 ifthenpay 付款功能。结账时仅提供一种付款方式，在设置中选择：Multibanco 参考号、MB WAY 或信用卡。使用 Multibanco 时，客户会获得实体编号（entity）、参考号和应付金额，可在 ATM 机或网上银行付款；使用 MB WAY 时，客户在 MB WAY 应用中确认付款请求；使用信用卡时，客户在 ifthenpay 安全卡页面付款，订单仅在付款确认后才会创建。
适用于在葡萄牙经营、以欧元销售，并拥有 ifthenpay 账户且持有所选方式密钥的商店。本模块每次安装仅提供一种 ifthenpay 付款方式。不支持通过 PrestaShop 退款、Payshop、Cofidis Pay、Apple Pay、Google Pay、PIX 或 Pay-by-Link，不支持订阅或保存的卡，不会自动过期未付款的 Multibanco 参考号，也不会轮询付款状态。
主要功能
Multibanco：为购物车总额生成动态参考号。订单进入 Awaiting ifthenpay payment 状态，参考号会显示在订单确认页面和订单确认电子邮件中。
MB WAY：客户输入绑定 MB WAY 的手机号码（葡萄牙号码或国际格式 351#912345678），并在应用中确认付款。
信用卡：在 ifthenpay 卡页面付款，通过已签名的返回（使用您的 Credit Card 密钥进行 HMAC-SHA256 签名）或回调进行确认。付款之前不存在订单。
受保护的回调：仅接受带有您的反钓鱼密钥的回调。伪造的请求永远不会更改订单。
金额检查：将已付金额与订单总额逐分核对。金额不符时，订单会进入 ifthenpay payment on hold 状态并附带备注。
防止重复处理：重复的回调和返回不会产生任何变化：一次付款、一条备注。已取消但随后付款的订单会被暂停以供审核，已退款的订单不会被重新打开。
测试模式与订单状态：信用卡和 Multibanco 在测试模式下使用 ifthenpay 沙盒。付款后，订单变为 Payment accepted 或 Delivered。
订单页面上的 ifthenpay 区块：带参考号或请求 ID 的付款尝试、针对等待中订单的警告以及模块备注。日志中不包含密钥或电话号码。
系统要求
PrestaShop 8.0 至 9.x，PHP 8.0 或更高版本。一个 ifthenpay 账户，持有所选方式的密钥，并且回调已由 ifthenpay 激活。购物车货币为欧元 (EUR)。一个来自 vibefox.net 的 VibeFox 许可证密钥（每个域名一个密钥）。