概述
VibeFox Datatrans Gateway 为 OpenCart 3 和 OpenCart 4 添加通过 Datatrans（瑞士支付服务提供商）的付款功能。在结账的最后一步，顾客点击 Confirm Order，被转到 Datatrans 付款页面，使用银行卡、TWINT、PostFinance 或您 Datatrans 账户中启用的其他方式付款，然后返回您的店铺。银行卡信息绝不会经过您的网站。OpenCart 在付款前就会创建订单，但订单只有在 Datatrans 确认付款后才会获得状态，因此未付款的尝试仍以缺失订单的形式保留。
适合拥有 Datatrans 商户账户、希望使用托管付款页面并在 OpenCart 订单页面退款的店铺。本扩展仅接受一次性付款。不支持保存的银行卡或别名、订阅、您网站上的 Lightbox 或 Secure Fields 集成、在设置中选择付款方式，也不支持对授权进行部分捕获。
主要功能
Datatrans 付款页面：以订单货币支付订单总额，包括无小数位和三位小数的货币。页面会根据店铺语言以德语、英语、法语或意大利语打开。
仅在 Datatrans 确认后标记为已付款：订单状态在收到经过签名的 Datatrans webhook 后，或通过 Datatrans 状态 API 进行服务器端检查后设置。之后，OpenCart 会发送常规订单邮件。
金额和货币检查：将 Datatrans 报告的金额和货币与订单进行比对。若不一致，订单将进入带备注的审核状态。
先授权，后捕获：关闭 Auto settle 时，付款仅授权。请在订单的 VibeFox Datatrans Gateway 选项卡中捕获或取消。
不会重复处理：重复的 webhook 和返回请求绝不会重复执行付款。同一购物车的新尝试会检查并关闭之前的 Datatrans 交易，因此购物车不能被付款两次。
沙盒和生产环境：商户 ID、API 密码和签名密钥各自独立。捕获和退款始终发送到付款时所用的环境。
在订单页面退款：在订单选项卡中进行全额或部分退款，并附有退款记录和 Datatrans 备注。全额退款会设置 Refunded 状态。
OpenCart 条件和状态：地理区域、最低订单金额、排序，以及您为已付款、待处理、已取消和已退款订单设置的自定义状态。可选日志，不包含密钥或客户数据。
系统要求
OpenCart 3.0.x（已在 3.0.5.0 上测试）或 OpenCart 4.0.2 及更高版本（已在 4.1.0.3 上测试），PHP 8.0 或更高版本。一个下载包同时包含两个版本的安装包。一个 Datatrans 账户，包含商户 ID、API 密码以及推荐使用的 HMAC 签名密钥。一个可从互联网访问的店铺，用于接收 webhook。一个来自 vibefox.net 的 VibeFox 许可证密钥（每个域名一个密钥）。