概述
VibeFox Culqi Payment 为 PrestaShop 添加秘鲁支付服务 Culqi。在付款步骤，顾客通过 Culqi Checkout 弹出窗口使用银行卡或 Yape 付款，全程无需离开您的店铺。银行卡信息在 Culqi 窗口中输入，绝不会到达您的服务器。随后由您的服务器通过 Culqi Charges API 创建扣款，并且只有在 Culqi 确认扣款后才会生成订单，因此被拒绝或中途放弃的付款不会产生未付款订单。
本模块适合位于秘鲁、以秘鲁索尔（PEN）或美元（USD）销售并拥有 Culqi 账户的店铺。本模块仅接受银行卡和 Yape 的一次性付款。不支持 PagoEfectivo 或 CIP 代码、银行应用、代理点、电子钱包或 Cuotéalo，不支持保存银行卡、订阅或分期付款，不使用 Culqi Webhook，也不支持单独的授权和扣款。
主要功能
Culqi Checkout 弹出窗口：银行卡（Visa、Mastercard、American Express、Diners Club），以及可选的 Yape，均在结账页面的窗口中完成。
3-D Secure：当银行要求时，Culqi 3-D Secure 会自动打开，验证完成后扣款随即完成。
仅在 Culqi 确认后才标记为已付款：Culqi 返回扣款成功后才会创建订单，并将扣款金额和币种与购物车进行比对。如果不一致，订单会被置为 Culqi payment on hold 状态并附带备注。
避免重复扣款：已生成订单或已存在 Culqi 扣款的购物车绝不会再次扣款，即使出现双击、第二个标签页或重试也一样。
清晰的拒绝提示：顾客会看到来自 Culqi 的消息，并可改用其他银行卡重试。拒绝代码会记录在模块日志中。
测试和正式模式：每种模式使用各自独立的公钥和私钥。退款始终使用付款时所在模式的密钥。
订单页面退款：可在订单的 Culqi payment 区块中进行全额和部分退款，退款金额不超过 Culqi 实际扣款的金额。全额退款会将订单设为 Refunded。
安全设置和日志：前缀错误的密钥会被拒绝，已保存的私钥不会再次显示。可选日志不含密钥、银行卡数据或顾客信息。
系统要求
PrestaShop 8.0 至 9.x，PHP 8.0 或更高版本。店铺币种为 PEN 或 USD。拥有公钥和私钥 API 密钥的 Culqi 账户。来自 vibefox.net 的 VibeFox 许可证密钥（每个域名一个密钥）。