概述
VibeFox Satispay Gateway 为 OpenCart 3 和 OpenCart 4 添加 Satispay 付款功能。顾客在最后一个结账步骤点击 Confirm Order,随后跳转到 Satispay 付款页面,在电脑上扫描二维码,或在手机的 Satispay 应用中确认付款,然后返回您的店铺。OpenCart 会在付款前创建订单,但只有扩展从 Satispay API 读取付款并核对其状态、金额和币种之后,订单才会获得状态;因此未付款的尝试仍会以缺失订单的形式保留。
本扩展适合以欧元销售、希望接受 Satispay 而无需复制 API 密钥的店铺:扩展通过 Satispay Business Dashboard 生成的一次性激活码进行连接。Satispay 仅收取 EUR,因此当顾客选择了其他币种时,付款方式会被隐藏。本扩展不支持订阅、已保存的付款方式、预授权或餐券,而在 Satispay Dashboard 中进行的退款不会记录到 OpenCart。
主要功能
一步完成连接:粘贴激活码并保存。扩展会创建自己的 RSA 密钥对,并对发送给 Satispay 的每个请求进行签名。
仅在 Satispay 确认后才视为已付款:既不信任 Satispay 的回调,也不信任顾客的返回。付款始终从 Satispay API 重新读取,并且必须是店铺为该订单创建的付款。
金额和币种核对:与订单总额不符的付款会使订单进入带备注的审核状态,而不会将其标记为已付款。
避免重复处理:重复或同时发生的回调和返回绝不会重复入账。新的付款尝试会取消该购物车之前待处理的 Satispay 付款,因此无法重复付款。
已放弃的付款会被关闭:顾客如果离开 Satispay 页面而未付款,该付款会在 Satispay 端被取消,并且顾客会在结账页面看到提示。购物车会保留。
正式环境与测试环境:每个环境使用独立的密钥。每笔付款都会记住其所属环境,回调和退款始终使用该环境。
从订单页面退款:在订单的 VibeFox Satispay Gateway 选项卡中进行全额或部分退款,退款上限为 Satispay 实际扣款的金额,并可查看该购物车的所有 Satispay 付款、退款历史和备注。
OpenCart 设置:您自己的订单状态、地理区域、最低订单金额和排序。日志不包含密钥或顾客数据,错误始终会被记录。
系统要求
OpenCart 3.0.x(已在 3.0.5.0 上测试)或 OpenCart 4.0.2 及更高版本(已在 4.1.0.3 上测试),PHP 8.0 或更高版本并启用 OpenSSL 扩展。一个下载文件包含两个版本的安装包。店铺已启用 EUR 币种。需要一个 Satispay Business 账户,以及来自 Satispay Business Dashboard 的激活码。您的店铺必须可以从互联网访问。需要一个来自 vibefox.net 的 VibeFox 许可证密钥(每个域名一个密钥)。
