概述
VibeFox Satispay Gateway 为 PrestaShop 添加 Satispay 付款功能。在付款步骤,顾客选择 Satispay,被引导至 Satispay 付款页面,可在电脑上扫描二维码,或在手机的 Satispay 应用中确认付款,然后返回您的店铺。只有在模块从 Satispay API 读取到付款并核对了状态、金额和币种之后才会创建订单,因此被放弃的付款不会留下未付款的订单。
本模块适合以欧元销售、希望在无需复制 API 密钥的情况下接受 Satispay 的店铺:模块通过 Satispay Business Dashboard 生成的一次性激活码进行连接。Satispay 仅收取 EUR,因此该付款方式在其他货币的购物车中会被隐藏。模块不支持订阅、已保存的付款方式、预授权或餐券,在 Satispay Dashboard 中进行的退款不会记录到 PrestaShop 中。
主要功能
一步完成连接:粘贴激活码并保存即可。模块会自行生成 RSA 密钥对,并对发送给 Satispay 的每个请求进行签名。
仅在 Satispay 确认后才付款成功:既不信任 Satispay 的回调,也不信任顾客的返回。付款信息始终从 Satispay API 重新读取,并且必须是店铺为该购物车创建的付款。
金额和币种核对:如果付款金额与购物车总额不符,订单将被置为 Satispay payment on hold 状态并附带备注,而不会被标记为已付款。
避免重复处理:重复或同时发生的回调和返回,永远不会产生第二个订单,也不会重复记录付款。新的付款尝试会取消之前待处理的 Satispay 付款。
关闭已放弃的付款:顾客离开 Satispay 页面而未付款时,该笔付款会在 Satispay 端被取消,顾客会在结账时看到提示信息。购物车会被保留。
正式环境与沙盒:每个环境使用独立的密钥。每笔付款都会记住其所属环境,回调和退款始终在该环境中进行。
订单页面退款:在 Satispay payment 区块中进行全额或部分退款,最高不超过 Satispay 实际收取的金额。全额退款会将订单设为 Refunded。
订单页面的 Satispay 区块:付款信息、该购物车的所有 Satispay 付款、退款记录以及模块备注。日志中不包含密钥或顾客数据,错误始终会被记录。
系统要求
PrestaShop 8.0 至 9.x,PHP 8.0 或更高版本并启用 OpenSSL 扩展,EUR 付款。需要 Satispay Business 账户,以及来自 Satispay Business Dashboard 的激活码。您的店铺必须可以从互联网访问。需要一个来自 vibefox.net 的 VibeFox 许可证密钥(每个域名一个密钥)。
