Square

免费

插件简介： 为 DouPHP 商城接入 Square 海外收单通道，买家用 Visa / MasterCard / Amex 信用卡或 Apple Pay 完成付款，与 Square 线下 POS 共用同一商户账户与对账体系，适合线下门店与跨境线上业务并存的商家。

申请准备： 需注册 Square 账号（squareup.com）并完成商户验证（名称、地址、行业类别、提现银行账户），随后登录 Square 开发者控制台 创建 Application 并开通 Online Checkout / Payments API。

需要获取的凭据：

1. Application ID：开发者控制台应用详情页显示，用于标识应用。
2. Access Token：在应用页面按生产环境（Production）生成，区分沙箱与正式，务必选择正确环境。
3. Location ID：商户 Locations 页面获取，决定收款与结算归属的门店主体。
4. Webhook 签名密钥（可选）：配置回调端点后生成，用于校验 Square 推送的支付事件。

在 DouPHP 中的启用与配置：

1. 安装插件：后台 → 插件扩展 → 安装插件，在 DouPHP 官方插件列表按名称找到「Square」→ 点击「安装」；系统自动从 douphp.com 抓取插件包并部署到 include/plugin/square/ 目录
2. 启用与配置：返回后台 → 插件扩展 → 管理插件，在已安装列表定位到「Square」→ 点击「启用」即进入插件配置页 → 按上文要求依次填入 Application ID / Access Token / Location ID 等凭据 → 保存
3. 停用与卸载：仍在管理插件页，对该行点「停用」临时关闭前台入口；点「删除」会连同该插件的配置数据一并移除，谨慎操作

常见问题： 报 "UNAUTHORIZED" 多为误用沙箱 Token 或 Token 过期需重新生成；Square API 金额以最小货币单位（如美分）传递，务必确认站点售价币种与 Square 结算币种一致；未配置 Webhook 时订单状态依赖买家跳回同步确认，个别浏览器中途关闭会延迟更新，建议开启回调；新商户首笔结算周期通常较长，属 Square 风控策略。