概述
VibeFox Square Gateway 通过 Square 为 WooCommerce 添加信用卡和借记卡付款功能。顾客在您结账页面中嵌入的安全 Square 银行卡表单（Square Web Payments SDK）内输入卡信息。您的服务器只会收到一次性令牌，并通过 Square Payments API 进行扣款。银行卡号和安全码绝不会到达您的网站。
本插件适合在美国、加拿大、澳大利亚、日本、英国、爱尔兰、法国和西班牙使用 Square、希望在自有结账页面接受银行卡付款的卖家。插件仅支持即时捕获的一次性银行卡付款。不支持保存银行卡、订阅、Apple Pay、Google Pay、Cash App Pay、Afterpay 或 Square 礼品卡，不支持仅授权付款，也不使用 Square Webhook。
主要功能
结账页面中的银行卡表单：Square 银行卡表单可用于经典结账、结账区块和「Pay for order」页面。
3-D Secure / SCA：银行卡令牌化时进行买家验证，并将金额、货币和账单联系人信息传递给 Square。英国和欧盟的卖家必须使用。
仅在 Square 确认后标记为已付款：只有当付款状态为 COMPLETED，且金额、货币、订单参考和位置与订单完全一致时，订单才会标记为已付款。任何异常情况都会使订单进入「暂停」状态并附带备注。
避免重复扣款：每个订单同一时间只允许一次付款尝试，请求具有幂等性；如果响应丢失，重新尝试时会先查找之前的付款，而不是再次扣除银行卡。
金额正确：JPY 等无小数位货币以整数单位发送，不乘以 100。
退款：可在 WooCommerce 订单页面进行全额和部分退款，退款始终发送到付款时所用的环境和位置。
保存时检查凭据：保存设置时，会与 Square 核对访问令牌、位置 ID 和位置货币。
清晰的提示信息：顾客会看到简短的提示（付款被拒、CVV 错误、需要 3-D Secure 等）；技术细节会记录在订单备注和日志中。兼容 HPOS。
系统要求
WordPress 6.0 或更高版本，WooCommerce 7.0 或更高版本，PHP 8.0 或更高版本。需要一个 Square 账户，并在 Square Developer Dashboard 中创建应用（Application ID、Access Token、Location ID）。商店货币必须与您的 Square 位置货币一致：USD、CAD、AUD、JPY、GBP 或 EUR。需要一个来自 vibefox.net 的 VibeFox 许可证密钥（每个域名一个密钥）。