用途:Square Online 是 Square 生态中的在线商店,免费起步,与 Square POS 共享同一套商品目录、库存、客户目录和订单簿。网站搭建器本身只能在界面操作,没有站点构建 API;可自动化的是商务层,即通过标准 Square API(Catalog、Orders、Inventory、Payments/Checkout)配合 webhook、OAuth 和官方 Square MCP 服务器进行集成。
主要能力与用法:自有账户用个人访问令牌(Bearer),多商户应用用 OAuth(令牌 30 天过期,需用刷新令牌续期)。请求需带 Square-Version: YYYY-MM-DD,基础地址 https://connect.squareup.com/v2,沙箱为 connect.squareupsandbox.com。购买驱动的自动化优先用 webhook 而非轮询,需校验 HMAC 并回查订单。库存以 Inventory API 为准,而非界面同步开关:按商品变体启用库存跟踪,订阅 inventory.count.updated,并定期对账以防超卖。
适用场景:将新订单同步到 CRM、修复 POS 与在线商店库存不同步、评估套餐与费率、设置 MCP 服务器等。
限制与注意:无站点构建 API,不能程序化修改页面或主题。免费套餐无月费但在线费率较高(约 3.3% + 30¢),使用 *.square.site 子域并显示广告;Plus/Premium 降低费率并解锁自定义域名、弃购邮件等。webhook HMAC 基于通知 URL 加原始请求体计算,URL 尾斜杠或 http/https 不匹配会导致校验失败。API 创建的订单需有履约和已完成支付才会显示在仪表板。税费自动计算仅限美国和加拿大。速率限制未公开,负载下可能返回 429,需指数退避重试。以上费率与套餐信息为研究整理,可能过时,请以官方当前信息为准。