# Square与Pilotiko：已连接您的收款账户，但不含任何自动操作

> 了解Square与Pilotiko集成：Pilotiko请求的三项OAuth权限、访问令牌的有效期限、目前仍需手动处理的环节，以及如何随时撤销Square对Pilotiko的访问授权，保障账户安全。

更新于 2026年11月8日 · https://app.pilotiko.com/zh/integrations/square

目前，Pilotiko可通过OAuth连接您的Square账户，并请求三项权限：PAYMENTS_READ、PAYMENTS_WRITE和MERCHANT_PROFILE_READ。它尚不会读取任何销售记录，也不会创建任何付款。状态：仅连接账户：目前没有任何自动操作。您的线下和线上销售仍保留在Square中。

## 要点
- 状态：仅连接账户：目前没有任何自动操作。
- 请求的权限：PAYMENTS_READ、PAYMENTS_WRITE、MERCHANT_PROFILE_READ。
- Square的访问令牌在30天后失效，需通过刷新令牌续期。
- 目前尚未接入销售记录读取、付款或退款功能。

## Pilotiko中的Square连接有什么作用？

它会加密保存您授予Pilotiko访问您Square商户账户的授权。目前还没有任何功能使用该授权。

Square常常同时用于两种场景：柜台终端和线上支付。Pilotiko将Square归入“收款”功能，状态为**仅连接**：授权流程已搭建完成，但针对您销售记录的任何操作尚未实现。因此，Pilotiko看不到周二早上在柜台完成的销售，也无法为其办理退款。

Square按权限所开放的接口来说明每项权限 [1]。Pilotiko请求了下列三项权限，为日后的收款和销售对账做准备。请求这些权限并不代表它们已被使用：目前没有调用Payments API，也没有调用Merchants API。

Square以JSON格式返回令牌；授权码有效期为5分钟，且只能使用一次 [2]。Pilotiko与Square之间不使用PKCE：令牌交换在服务器端使用应用密钥完成。

- **PAYMENTS_READ**：读取付款记录，例如ListPayments或GetPayment [1]。目前未使用。
- **PAYMENTS_WRITE**：创建、取消和退还付款，例如CreatePayment或RefundPayment [1]。目前未使用；日后若要使用，也将等待人工批准。
- **MERCHANT_PROFILE_READ**：读取商户账户及其销售点的信息，例如ListLocations或RetrieveMerchant [1]。目前未使用。

## 如何将Square连接到Pilotiko？

进行授权的Square账户必须是企业的账户。如果Pilotiko尚未启用其Square应用，卡片会提示这一点，且不显示按钮。

1. **找到Square卡片** — 在Pilotiko的“连接”页面，“收款”分组中。
2. **发起连接** — 点击“连接”；Pilotiko会生成一次性请求，有效期10分钟，并与您的企业和您本人绑定。
3. **查看Square授权页面** — Square会显示所请求的三项权限；请确认这是正确的商户账户。
4. **授权** — Square会携带授权码将您重定向回Pilotiko；Pilotiko用授权码换取令牌并加密保存。
5. **核对** — 卡片状态变为“已连接”，并注明不会执行任何自动操作。

## Square目前有哪些功能可用，哪些即将推出？

| 功能 | 状态 | 说明 |
|---|---|---|
| 连接Square商户账户 | 仅连接账户：目前没有任何自动操作 | 请求三项权限，令牌已加密 |
| 读取柜台和线上销售记录 | 即将推出 | 未调用Payments API |
| 创建付款或退款 | 即将推出 | 将需要人工批准 |
| 读取您的销售点（Locations） | 即将推出 | 未调用Merchants API |
| 在Pilotiko端断开Square | 可用 | 令牌被清除，并记入审计日志 |

## Pilotiko能看到Square一天的销售情况吗？

**示例：一家有2个销售点的美发沙龙，某个周六在Square上有41笔销售**

这家沙龙在两家分店都用Square在柜台收款，并通过线上收取少量预付定金。Square已连接到Pilotiko一周。

- 柜台销售（2家分店） : 35
- 线上支付的定金 : 6
- Pilotiko读取的销售记录 : 0
- Pilotiko读取的销售点 : 2个中读取0个
- Pilotiko办理的退款 : 0
- **= 这41笔销售仍保留在Square中；在Pilotiko里，当天的预约不会被自动标记为“已付款”。**

## 您的Square数据如何受到保护（Loi 25）？

Square令牌在存储时已加密（AES-256-GCM），在界面和日志中均不会显示。根据魁北克私营部门法律，任何企业都须对其持有的个人信息负责，由最高负责人确保遵守法律 [3]。目前Pilotiko不收集任何Square销售数据：除令牌本身外，没有其他需要保护的内容。

一旦开始读取销售记录，其中会包含您客户的个人信息；届时法律规定客户享有查阅权，并可应要求获得结构化、常用格式的副本 [3]。CAI提醒，这项数据可携权自2024年9月22日起适用 [4]。详情请见：[您的权利](/vos-droits)和[分包商](/sous-traitants)。

撤销：在Pilotiko中，点击“断开连接”会清除令牌，并将该操作记入审计日志。在Square中，商户可撤销该应用的访问权限，这会使其令牌失效 [2]。

## Square有哪些特有的限制？

Square的访问令牌在30天后失效 [2]。因此，长期未使用的连接需要通过刷新令牌续期，否则就要重新连接。Pilotiko用于Square的OAuth应用尚未注册。

如果只需要线上收款，请与[Stripe](https://app.pilotiko.com/zh/integrations/stripe)比较；如果使用其他品牌的终端，请参阅[Clover](https://app.pilotiko.com/zh/integrations/clover)。所有连接都在[集成](https://app.pilotiko.com/zh/integrations)页面，而您的预约也可以通过迁移从[Acuity Scheduling](https://app.pilotiko.com/zh/integrations/acuity-scheduling)导入。

## 常见问题

### Pilotiko能看到我在Square终端上完成的销售吗？

目前不能。读取权限已被请求，但尚未安排任何读取。您的销售记录仅在Square中可见。

### 如果Pilotiko不创建付款，为什么还要请求PAYMENTS_WRITE？

这样日后接入收款功能时，就无需再次向您申请授权。目前不会创建任何付款，日后的任何付款也都将等待人工批准。

### Square的授权有效期多长？

Square的访问令牌在30天后失效，并提供刷新令牌以获取新令牌。如果续期失败，卡片会变为“需重新连接”。

### 我可以连接多个Square分店吗？

连接是在商户账户层面进行的，该账户涵盖其所有销售点。Pilotiko目前还不会读取这些销售点的列表。

### 如何切断Pilotiko对Square的访问？

在Pilotiko中点击“断开连接”即可清除令牌。您也可以在Square中撤销该应用，这会使其令牌失效。

### 我的客户在收款时会看到变化吗？

不会。Square中没有任何变化：柜台和您的线上支付链接都保持不变。

## 资料来源

1. Square Developer, « OAuth permissions reference », https://developer.squareup.com/docs/oauth-api/square-permissions (查阅于 2026-10-15)
2. Square Developer, « OAuth API overview », https://developer.squareup.com/docs/oauth-api/overview (查阅于 2026-10-15)
3. LégisQuébec, « Loi sur la protection des renseignements personnels dans le secteur privé (RLRQ, c. P-39.1) », https://www.legisquebec.gouv.qc.ca/fr/document/lc/P-39.1 (查阅于 2026-10-15)
4. Commission d'accès à l'information du Québec, « Principaux changements apportés par la Loi 25 », https://www.cai.gouv.qc.ca/protection-renseignements-personnels/sujets-et-domaines-dinteret/principaux-changements-loi-25 (查阅于 2026-10-15)
