概述
VibeFox Eupago Gateway 为 PrestaShop 添加面向葡萄牙的 Eupago 付款方式。您可在结账时选择一种付款方式：Multibanco、MB WAY 或信用卡。选择 Multibanco 时，顾客会获得实体编号（entity）和参考编号，可在 ATM 机或网上银行付款。选择 MB WAY 时，顾客需在 MB WAY 应用中确认付款请求。选择信用卡时，顾客在 Eupago 银行卡页面付款，然后返回您的商店。
本模块适合以欧元销售且拥有 Eupago 账户的商店。每次安装仅提供一种 Eupago 付款方式，且仅支持一次性付款。不支持通过 PrestaShop 退款（请在 Eupago 后台办理退款），不支持保存银行卡、订阅或预授权，不支持 PayShop、Cofidis Pay、Bizum 等其他 Eupago 付款方式，也不支持短信提醒、Multibanco 到期日和状态轮询。
主要功能
Multibanco、MB WAY 或银行卡：Multibanco 参考编号会显示在订单确认页面，并添加到订单确认邮件中。结账时会询问 MB WAY 手机号码，葡萄牙号码可省略 +351 输入。
仅在 Eupago 确认后标记为已付款：只有经过验证的 Eupago 通知（已签名的 Webhook 2.0，或由您的 API 密钥验证的旧版回调）才会将订单标记为已付款。对于银行卡付款，只有在 Eupago 确认付款后才会创建订单。
严格核对：金额（精确到分）和币种必须与订单一致，付款参考编号必须是为该购物车创建的，且通知必须来自相同环境（沙盒或正式）。任何不符的情况都会将订单置为 Eupago payment on hold 并附加备注。
避免重复处理：重复通知只会被处理一次，因此不会产生重复订单、备注或状态邮件。已取消订单的迟到付款会被置为保留以供审核，而不会丢失。
沙盒与正式环境：每种模式都有独立的 API 密钥和 Webhook 密钥。切换模式会同时切换密钥和 Eupago 服务器地址。
可选的订单状态：付款后设为 Payment accepted 或 Delivered，仅更改一次状态。
订单页面上的 Eupago 区块：显示付款尝试记录，包括付款方式、参考编号或隐藏部分数字的手机号、Eupago 交易 ID 和状态，以及模块备注。可选日志不记录密钥、邮件或完整手机号码。
系统要求
PrestaShop 8.0 至 9.x，PHP 8.0 或更高版本。需要一个 Eupago 账户，并持有您渠道的 API 密钥以及 Webhook 2.0 密钥（沙盒与正式环境为独立账户）。购物车货币为 EUR。还需要一个来自 vibefox.net 的 VibeFox 许可证密钥（每个密钥对应一个域名）。