概述
VibeFox Culqi Payment 为 OpenCart 3 和 OpenCart 4 添加秘鲁支付服务 Culqi。在结账的最后一步，顾客点击 Confirm Order，然后在 Culqi Checkout 弹出窗口中使用银行卡或 Yape 付款，无需离开您的店铺。银行卡信息在 Culqi 窗口中输入，绝不会传到您的服务器。随后，您的服务器通过 Culqi Charges API 发起扣款。OpenCart 在付款前就会创建订单，但订单只有在 Culqi 确认扣款后才会获得状态，因此被拒绝或中途放弃的付款会以“缺失订单”的形式保留。
适合在秘鲁经营、以秘鲁索尔（PEN）或美元（USD）销售并拥有 Culqi 账户的店铺。本扩展仅接受银行卡和 Yape 的一次性付款。不支持银行应用、代理、电子钱包或 Cuotéalo，也不支持保存的银行卡、订阅或分期，不支持 Culqi webhook，也不支持单独的授权和捕获。
主要功能
Culqi Checkout 弹出窗口：在结账确认步骤的窗口中显示银行卡（Visa、Mastercard、American Express、Diners Club），并可选择显示 Yape。
3-D Secure：当银行要求时，Culqi 3-D Secure 会自动打开，并在身份验证后完成扣款。
仅在 Culqi 确认后标记为已付款：Culqi 返回扣款成功后才会设置订单状态，扣款金额和货币会与订单进行比对。若不一致，订单将进入带备注的审核状态。之后，OpenCart 会发送常规订单邮件。
不会重复扣款：已有 Culqi 扣款的订单，即使顾客双击、打开第二个标签页或重试，也不会再次扣款。
清晰的拒付提示：顾客会看到 Culqi 返回的信息，并可以在同一步骤尝试其他银行卡。订单备注和日志会保留拒付代码。
测试和正式模式：每种模式各有独立的公钥和私钥。退款始终使用付款时所用模式的密钥。
在订单页面退款：在订单的 VibeFox Culqi Payment 选项卡中可进行全额或部分退款，金额上限为 Culqi 实际扣款的金额。全额退款会设置 Refunded 状态。
OpenCart 条件与安全设置：地理区域、最低订单金额、排序以及您自定义的订单状态。前缀错误的密钥会被拒绝，已保存的私钥不会再次显示。可选日志不包含密钥、银行卡信息或顾客详细信息。
系统要求
OpenCart 3.0.x（已在 3.0.5.0 上测试）或 OpenCart 4.0.2 及更高版本（已在 4.1.0.3 上测试），PHP 8.0 或更高版本。一个下载包同时包含两个版本的安装包。店铺已启用 PEN 或 USD 货币。一个带有公钥和私钥的 Culqi 账户。一个来自 vibefox.net 的 VibeFox 许可证密钥（每个域名一个密钥）。