用途：通过 Square Connect v2 API 管理 Square 卖家账户中的支付、订单、客户、目录商品、发票与库存。适用于收款、退款、查询订单、读取销售数据、更新目录商品与库存等操作。
主要能力：列出位置（location ID 是多数订单、支付、库存调用的必填项）；列出、查询、创建支付与退款；查询与创建订单、列出与搜索客户、创建客户；列出与创建目录对象（含商品、分类、税、折扣）；搜索与检索发票；查询库存数量。
必要用法：先连接 Square 连接器（app.vm0.ai/connectors）。所有端点需 Bearer 令牌：Authorization: Bearer $SQUARE_TOKEN，并始终发送 Square-Version 头以固定 API 版本，例如 Square-Version: 2025-04-16。生产基址为 https://connect.squareup.com，端点均在 /v2 路径下；沙箱为 https://connect.squareupsandbox.com 且需独立令牌。请求失败可运行 zero doctor check-connector --env-name SQUARE_TOKEN 或 zero doctor check-connector --url https://connect.squareup.com/v2/locations --method GET 排查。
限制与注意：金额以最小货币单位整数表示（如 1000 = 10.00 USD）；创建类 POST 请求均需唯一 idempotency_key，重复使用会返回原结果而非新建；列表端点返回游标，作为 cursor 参数翻页；速率限制按账户，遇 429 应退避重试；生产令牌不能用于沙箱主机，反之亦然；vm0 连接器指向生产环境。