概述
VibeFox dLocal Payment 将 OpenCart 3 和 OpenCart 4 与 dLocal 的自助服务产品 dLocal Go 连接起来。顾客在结账的最后一步点击 Confirm Order,被转到 dLocal Go 付款页面,使用其所在国家/地区的本地付款方式(银行卡、银行转账、现金凭证或电子钱包)完成付款,然后返回您的店铺。银行卡信息从不经过您的网站。OpenCart 会在付款前创建订单,但只有在 dLocal Go 确认付款后,订单才会获得状态,因此未付款的尝试会保留为缺失订单。
本扩展适合在拉丁美洲、非洲和亚洲销售且拥有 dLocal Go 账户的店铺。扩展仅支持一次性付款。您的网站上没有银行卡表单,不支持保存的银行卡、订阅、分开的授权与扣款,也不能与 dLocal Payments 企业版 API(X-Login / X-Trans-Key 凭据)配合使用。
主要功能
dLocal Go 付款页面:按订单币种和顾客所在国家/地区,为订单总额创建一笔付款。金额遵循各币种的小数位规则,例如 CLP 和 JPY 使用整数金额。
仅在 dLocal Go 确认后标记为已付款:付款通知会通过签名进行校验,付款状态、金额和币种始终从 dLocal Go API 重新读取。顾客返回时也会检查状态。随后,OpenCart 会发送其常规订单邮件。
金额与币种核对:与订单不符的付款会使订单进入带备注的审核状态,而不会被标记为已付款。
避免重复处理:重复的通知和返回操作绝不会把同一笔付款应用两次。在开始新的付款之前,会检查同一顾客会话中未完成的付款,已付款的交易会被确认,而不是再次扣款。
沙盒与正式环境:每个环境使用各自独立的凭据。付款的通知和退款始终使用该付款所在环境的凭据。
在订单页面退款:可在订单的 VibeFox dLocal Payment 选项卡中进行全额和部分退款,金额和币种与 dLocal Go 的扣款一致。全额退款会将状态设为 Refunded,dLocal Go 返回的最终退款状态会添加到备注中。
对顾客友好的重试:顾客如果在未付款的情况下离开 dLocal Go 页面,会在结账时看到提示,并可以重试或选择其他付款方式。
OpenCart 条件与状态:地理区域、最低订单金额、排序,以及您自定义的已付款、已完成、审核中和已退款订单状态。可选日志不包含凭据或个人数据。
系统要求
OpenCart 3.0.x(已在 3.0.5.0 上测试)或 OpenCart 4.0.2 及更高版本(已在 4.1.0.3 上测试),PHP 8.0 或更高版本。一个下载包同时包含两个版本的安装包。一个带有 API 密钥和 API 密钥密文的 dLocal Go 账户。店铺需可通过 HTTPS 从互联网访问,以接收通知。一个来自 vibefox.net 的 VibeFox 许可证密钥(每个域名一个密钥)。
