概述
VibeFox MercadoPago Gateway 为 OpenCart 3 和 OpenCart 4 添加通过 MercadoPago Checkout API 进行的信用卡和借记卡付款功能，适用于阿根廷、巴西、智利、哥伦比亚、墨西哥、秘鲁和乌拉圭的 MercadoPago 账户。在 Confirm Order 步骤，顾客在 MercadoPago 提供的安全 MercadoPago.js 字段中输入卡片信息，因此卡片数据永远不会到达您的网站。MercadoPago 将卡片转换为一次性令牌，您的店铺在服务器上创建付款。OpenCart 在付款前创建订单，但订单只有在 MercadoPago 响应后才会获得状态，因此被拒绝的卡片会留下没有状态的订单。
本扩展适合以 MercadoPago 账户的货币销售、并希望在自有结账页面显示卡片表单且支持分期付款的店铺。扩展仅接受银行卡付款。不支持 Checkout Pro 跳转、MercadoPago 钱包、现金、Pix、PSE 或 Yape 付款，不支持保存的卡片或订阅，不支持单独的授权与capture（扣款），也不支持货币换算。
主要功能
结账页面上的卡片表单：卡号、有效期和安全码位于 MercadoPago 字段中；持卡人姓名；在国家要求时提供持卡人证件；必要时提供发卡行；以及 MercadoPago 为订单总额提供的分期付款（cuotas、parcelas），并受您设置的 Maximum installments 限制。
仅在 MercadoPago 确认后标记为已付款：金额和货币一致的已批准付款会将订单设为您选择的已付款状态；审核中的付款会保持在其自身状态，直到 MercadoPago 通知完成处理。金额不一致时，订单会进入带有备注的审核状态。之后，OpenCart 会发送其常规订单电子邮件。
安全通知：在订单变更前，每条通知都会从 MercadoPago API 重新读取，并可选择进行 x-signature 签名校验。
防止重复扣款：按购物车加锁、为每个卡片令牌设置幂等键，并查询丢失的响应，可防止因重复点击、第二个标签页或超时而导致的重复扣款。已付款的购物车不会再次扣款。
测试和正式模式：分别使用 TEST- 和 APP_USR- 凭据，保存时会按前缀并与账户所在国家进行核对。退款和通知使用付款时所处模式的凭据。
从订单页面退款：在订单的 VibeFox MercadoPago Gateway 选项卡中进行全额或部分退款，金额不超过实际扣款金额，并可查看付款详情、退款记录和 MercadoPago 备注。全额退款会将状态设为 Refunded。
您自己的订单状态和 OpenCart 条件：为已付款订单、MercadoPago 审核中的付款、暂挂付款、付款失败、已取消订单和已退款订单选择 OpenCart 状态。支持地理区域、最低订单金额和排序。日志不包含令牌、卡片或付款人数据。
系统要求
OpenCart 3.0.x（已在 3.0.5.0 上测试）或 OpenCart 4.0.2 及更高版本（已在 4.1.0.3 上测试），PHP 8.0 或更高版本。同一个下载文件包含两个版本的安装包。店铺中已启用与您的 MercadoPago 账户货币相同的货币（ARS、BRL、CLP、COP、MXN、PEN 或 UYU）。一个 MercadoPago 应用，并带有测试和正式环境的 Public Key 与 Access Token。一个来自 vibefox.net 的 VibeFox 许可证密钥（每个域名一个密钥）。