概述
VibeFox Conekta Gateway 通过 Conekta（墨西哥）为 PrestaShop 添加付款功能。在付款步骤中，顾客选择 Conekta，随后被跳转至由 Conekta 托管的安全付款页面，可根据您允许的付款方式，使用信用卡或借记卡付款，或在 OXXO 和其他门店支付现金，或通过 SPEI 银行转账付款，或使用 BNPL 付款。付款完成后，顾客返回您的店铺。银行卡信息绝不会到达您的网站。只有在 Conekta 确认付款或发出 OXXO 或 SPEI 付款参考号之后才会创建订单，因此未完成的付款不会留下未付款的订单。
本模块适合以 MXN 或 USD 销售、希望通过一个 Conekta 账户以单一付款方式接受银行卡和现金付款的墨西哥店铺。本模块仅支持一次性付款。结账页面上没有银行卡表单，不支持保存的银行卡、订阅、预授权和扣款，也不支持按月分期（MSI）。在 Conekta 控制面板中进行的退款或拒付只会在订单中添加备注，不会自动记录。
主要功能
Conekta 托管付款页面：将按购物车币种和购物车总额创建 Conekta 订单。现金、SPEI 和 BNPL 仅适用于 MXN 购物车；USD 购物车仅支持银行卡。
仅在 Conekta 确认后才标记为已付款：Webhook 和顾客返回都只会触发通过您的私钥从 Conekta API 读取订单。对于通知或返回 URL 中的任何内容，均不予信任。
金额和币种核对：付款金额（以分为单位）和币种将与购物车进行比对。若存在任何差异，或店铺处于正式模式时收到测试模式付款，订单将被置于 Conekta payment on hold 状态以供审核。
OXXO 和 SPEI：顾客获得付款参考号后，订单将以 Awaiting Conekta payment 状态创建，并在 Conekta 报告付款后变为 Payment accepted。
避免重复处理：重复或同时收到的通知绝不会创建第二个订单，也不会重复记录付款。在创建新的 Conekta 付款页面之前，会复用或取消已打开的付款页面，确保旧链接不会被支付两次。
测试和正式模式：每种模式使用单独的私钥，并在结账页面显示 TEST MODE 提示。退款和通知始终使用付款时所处模式的密钥。
在订单页面退款：可在订单的 Conekta payment 区块中进行全额或部分退款，金额上限为 Conekta 实际收取的金额。全额退款会将订单设为 Refunded。
订单页面的 Conekta 区块：Conekta 订单、扣款、状态、金额、退款记录以及模块备注。可选日志不含 API 密钥或顾客联系信息。
系统要求
PrestaShop 8.0 至 9.x，PHP 8.0 或更高版本。购物车币种为 MXN 或 USD。需要一个 Conekta 账户，并持有测试和正式私钥，以及在 Conekta 控制面板中设置的 Webhook。还需要一个来自 vibefox.net 的 VibeFox 许可证密钥（每个密钥对应一个域名）。