概述
VibeFox Moyasar Payment Gateway 通过 Moyasar 托管的付款页面为 PrestaShop 添加付款功能。在付款步骤，顾客选择 Moyasar，随后被引导至为购物车创建的 Moyasar 付款页面，可使用 mada、Visa、Mastercard、Apple Pay、STC Pay 或您的 Moyasar 账户中启用的其他方式付款，付款后返回您的店铺。只有在 Moyasar 确认付款后才会创建订单，因此中途放弃的付款不会留下未付款订单。
本模块适合希望通过 Moyasar 账户接受本地及国际付款的沙特阿拉伯及海湾合作委员会（GCC）地区店铺。模块仅支持一次性付款。您自己的结账页面上没有银行卡表单，也不支持保存银行卡、订阅，以及单独的授权和扣款。Moyasar 页面上显示哪些付款方式，由您的 Moyasar 账户决定，而非模块。
主要功能
Moyasar 付款页面：以购物车货币为购物车总额创建发票：SAR、AED、USD、EUR、KWD、BHD 或 OMR。三位小数的货币会被正确换算为 fils。
仅在 Moyasar 确认后才标记为已付款：模块会先使用您的密钥通过 Moyasar API 读取发票，然后才创建订单。顾客返回、发票通知及可选的 Webhook 均采用相同的验证方式。
金额与货币核对：将已付金额和货币与购物车进行比对。如不一致，订单将进入 Moyasar payment on hold 状态并附上备注。
避免重复处理：即使多个确认同时到达，每笔付款也只会被处理一次。购物车总额变更后，旧的付款页面会被关闭。
测试模式与正式模式：两种模式使用各自独立的密钥。每笔付款都会使用付款时所用模式的密钥进行核验和退款。
在订单页面退款：在 Moyasar payment 区块中可进行全额或部分退款，退款金额不超过 Moyasar 的实际扣款金额。两小时内完成的银行卡付款进行全额退款时，将以撤销（void）方式处理。在 Moyasar Dashboard 中进行的退款会记录在订单备注中。
订单状态可选：付款成功后，可通过一次状态变更设为 Payment accepted、Delivered 或 Moyasar payment on hold。
订单页面的 Moyasar 区块：包含发票、付款、银行卡、退款记录以及模块备注。日志不包含密钥、银行卡数据或顾客信息。
系统要求
PrestaShop 8.0 至 9.x，PHP 8.0 或更高版本。需要一个 Moyasar 账户及其 API 密钥（秘密密钥）；建议在 Moyasar Dashboard 中设置 Webhook。还需要一个来自 vibefox.net 的 VibeFox 许可证密钥（每个密钥对应一个域名）。