概述
VibeFox Square Gateway 通过 Square 为 OpenCart 3 和 OpenCart 4 添加信用卡和借记卡付款功能。在 Confirm Order 步骤中，顾客在 Square 的安全银行卡表单（Square Web Payments SDK）中输入卡信息。您的服务器只会收到一次性令牌，并通过 Square Payments API 完成扣款。银行卡数据绝不会到达您的店铺。OpenCart 会在付款前创建订单，但订单只有在 Square 作出响应后才会获得状态，因此被拒绝的尝试仍会以缺失订单的形式保留。
本扩展适合希望在自有结账页面接受银行卡付款的 Square 商家，付款货币须为其 Square 站点的货币：USD、CAD、AUD、JPY、GBP 或 EUR。扩展支持一次性银行卡付款，并会立即扣款。不支持保存银行卡、订阅、Apple Pay、Google Pay、Cash App Pay、Afterpay 或 Square 礼品卡，也不支持仅授权付款，且不使用 Square Webhook。
主要功能
3-D Secure / SCA：银行卡令牌化时执行买家验证，订单总额、货币和付款地址会一并发送给 Square。
仅在 Square 确认后标记为已付款：只有当付款状态为 COMPLETED，且金额、货币、订单参考和站点与订单完全一致时，订单才会标记为已付款。任何异常情况都会使订单进入带备注的审核状态。
避免重复扣款：每个购物车同一时间只允许一次付款尝试，请求具有幂等性；若某次尝试的响应丢失，将先在 Square 中查询，而不会再次扣款。
凭据与货币检查：保存时会与 Square 核对访问令牌和站点。对于 Square 站点无法收款的货币所对应的订单，将隐藏该付款方式。
订单页面退款：可在订单的 VibeFox Square Gateway 选项卡中进行全额或部分退款，并始终使用实际付款所在的环境、站点、金额和货币。全额退款后订单状态设为 Refunded。
订单页面的 Square 选项卡：显示付款 ID（链接至 Square 控制面板）、银行卡信息、收据、退款记录和备注。
清晰的提示信息：顾客会看到简短提示（被拒绝、CVV 错误、需要 3-D Secure）。错误始终会被记录，但日志中不包含密钥或银行卡数据。
OpenCart 条件设置：您自定义的订单状态、地理区域、最低订单金额和排序。
系统要求
OpenCart 3.0.x（已在 3.0.5.0 上测试）或 4.0.2 及更高版本（已在 4.1.0.3 上测试），PHP 8.0 或更高版本。下载文件内含两个 OpenCart 版本的安装包。一个在 Square Developer Dashboard 中创建了应用的 Square 账户（Application ID、Access Token、Location ID）。订单货币须与您的 Square 站点货币一致：USD、CAD、AUD、JPY、GBP 或 EUR。一个来自 vibefox.net 的 VibeFox 许可证密钥（每个密钥对应一个域名）。