概述
VibeFox Yoco Pay Gateway 通过 Yoco Checkout API 为 PrestaShop 添加以南非兰特（ZAR）计价的银行卡和 Instant EFT 付款功能。顾客在付款步骤选择 Yoco，被转到 Yoco 托管的付款页面，在那里完成付款后返回您的店铺。银行卡信息绝不会经过您的网站，未完成的付款也不会留下未付款订单。
本模块适合以 ZAR 销售、并拥有已开通在线付款功能的 Yoco 账户的南非店铺。模块仅支持一次性付款。不支持保存银行卡、订阅、网站内嵌的银行卡表单，也不支持单独的授权和扣款；模块仅适用于 ZAR，订单最低金额为 R2.00。
主要功能
Yoco 托管付款页面：按购物车总额（以分为单位）创建 Yoco checkout。双击或超时后的重复请求会获得同一个 checkout，而不会生成第二个。
仅在 Yoco 确认后才标记为已付款：顾客返回时以及收到已签名的 Webhook 时，模块都会向 Yoco 查询 checkout 状态。只有 Yoco 报告 checkout 已完成，才会创建订单。
为您设置 Webhook：保存密钥后，模块会为该模式在 Yoco 注册其 Webhook URL，并存储签名密钥。没有有效签名的 Webhook 会被拒绝。
金额与币种核对：金额或币种不符的付款会使订单进入 Yoco payment on hold 状态并附带备注。针对已取消或已退款订单的付款不会使其重新开启。
避免重复处理：Webhook 与顾客返回同时到达时会依次处理。一个购物车、一个订单、一笔已记录的付款。
订单页面退款：在订单的 Yoco payment 区块中进行全额和部分退款，退款金额以 Yoco 实际扣款金额为准，并使用付款时所用模式的密钥。在 Yoco 后台进行的退款会自动记录。
测试与正式模式：每种模式各有独立的密钥和 Webhook 签名密钥。前缀错误的密钥不会被保存。
订单页面的 Yoco 区块：付款信息、购物车的所有付款尝试、退款记录以及模块备注。日志中的密钥和电子邮件地址已做脱敏处理。
系统要求
PrestaShop 8.0 至 9.x，PHP 8.0 或更高版本。店铺货币为南非兰特（ZAR）。需要一个开通了在线付款功能的 Yoco 账户及其密钥。需要一个来自 vibefox.net 的 VibeFox 许可证密钥（每个域名一个）。