概述
VibeFox Redsys Gateway 为 OpenCart 3 和 OpenCart 4 添加通过 Redsys(西班牙银行的虚拟 POS,即 Servired / Sermepa)进行的银行卡付款。顾客在结账最后一步点击 Confirm Order 后,会被转到其银行的安全 Redsys 付款页面,在那里使用 3-D Secure 进行银行卡付款,或使用 Bizum 以及您的银行为该终端启用的其他方式付款,然后返回您的店铺。银行卡信息绝不会经过您的网站。OpenCart 会在付款前创建订单,但只有在收到经过签名的 Redsys 通知后,订单才会获得状态,因此未付款的尝试会保留为缺失订单。
适用于银行提供 Redsys 终端的西班牙店铺。本扩展仅支持一次性付款,付款会立即授权并扣款。它不提供您自己网站上的银行卡表单(InSite 或 iframe),也不支持保存的银行卡或一键付款、订阅,以及先授权后扣款的预授权。
主要功能
Redsys 付款页面:为订单金额生成经过签名(HMAC SHA-256)的付款表单,使用订单货币,并按每种货币使用正确的小数位;在 Redsys 支持时使用顾客的语言。
仅在 Redsys 确认后付款:只有经过签名的服务器通知才会设置订单状态,并且会先将金额和货币与订单进行比对。付款通知网址随每笔付款一起发送,因此无需在 Redsys 后台进行任何复制设置。
真实资金安全:测试付款在正式模式下绝不会为订单付款;金额与订单总额不符的付款会附带备注,等待您审核。
避免重复处理:重复的通知只会应用一次。每次尝试都会获得新的 Redsys 订单号,同一购物车的第二笔付款绝不会改变订单;备注会提示您进行退款。
从订单页面退款:通过 Redsys REST API,在订单的 VibeFox Redsys Gateway 选项卡中进行全额或部分退款,并使用付款时的环境和货币。全额退款会将订单设为 Refunded 状态。
测试和正式环境:为 Redsys 测试环境(SIS-T)和正式环境分别设置独立的密钥。Redsys 的公开测试数据显示在设置页面上。
您自己的订单状态:付款后可选择 Processing、Completed 或 On hold (review),并将每个状态以及 Refunded 映射到 OpenCart 的订单状态。
OpenCart 条件:地理区域、最低订单金额和排序。日志始终记录错误,且不包含密钥、签名或银行卡数据。
系统要求
OpenCart 3.0.x(已在 3.0.5.0 上测试)或 OpenCart 4.0.2 及更高版本(已在 4.1.0.3 上测试),PHP 8.0 或更高版本。一个下载包包含两个版本的安装包。来自您银行的 Redsys 终端,具备商户代码(FUC)、终端号和 SHA-256 密钥,并已启用在线通知(HTTP)。来自 vibefox.net 的 VibeFox 许可证密钥(每个域名一个密钥)。
