# Clover 与 Pilotiko：连接您的终端账户

> Clover 与 Pilotiko 集成指南：了解商户授权如何完成、为何不传递任何权限范围、哪些功能尚未接入，以及如何随时撤销访问权限，让您放心连接并管理 Clover 账户。

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

Pilotiko 目前可以连接您的 Clover 商户账户：您在 Clover 登录并授权应用，Pilotiko 会加密保存令牌。它不会读取终端上的任何交易，也不会创建任何交易。状态：仅连接账户：目前没有任何自动操作。

## 要点
- 状态：仅连接账户：目前没有任何自动操作。
- 请求中未填写任何权限范围：在 Clover，访问权限取决于应用本身。
- Clover 会发放一对有时效的令牌，需要定期续期。
- 目前未接入任何终端订单或付款的读取功能。

## Clover 连接在 Pilotiko 中有什么作用？

它通过 OAuth 将您的 Clover 商户账户连接到 Pilotiko。目前连接之后不会再发生其他任何事情。

Clover 对其 OAuth 的描述很简单：商户登录并授权应用访问其数据，然后带着一个代码被重定向回应用，应用用该代码换取访问令牌和刷新令牌 [1]。Pilotiko 完全遵循这一流程。在 Pilotiko 的集成目录中，Clover 归入“收款”类别，状态为**仅连接**。

从代码中可以看出一个特点：发送给 Clover 的请求**不包含任何权限范围**，列表为空。Clover 指出，调用其 REST API 需要带有特定权限的令牌 [2]，但其页面没有说明这些权限在哪里设置，因此我们在此不作断言。可以确定的是：Pilotiko 不会用该令牌发起任何调用。

代码的交换在服务器端以 JSON 格式完成，不使用 PKCE。Clover 将 PKCE 保留给“低信任度”的应用，例如无法保管密钥的移动或桌面应用 [1]；Pilotiko 的密钥保存在其服务器上。

- **目前读取的数据**：无。没有订单、没有付款，也没有终端库存。
- **目前写入的数据**：无。没有付款、没有退款，也没有商品修改。
- **保存的内容**：加密的访问令牌和刷新令牌，以及已连接账户的名称。
- **需要经过批准的事项**：今后任何退款或收款，以及 Pilotiko 任何涉及资金的操作。

## 如何将 Clover 连接到 Pilotiko？

请使用商家所有者或管理人员的 Clover 账号进行操作。如果 Pilotiko 尚未为您的账户启用其 Clover 应用，卡片上会显示提示，而不是按钮。

1. **打开“连接”页面** — 在 Pilotiko 中，找到“收款”下的 Clover 卡片。
2. **点击“连接”** — Pilotiko 会创建一次性请求，与您的企业和用户绑定，10 分钟后失效。
3. **登录 Clover** — 输入您的 Clover 登录信息，并选择相应的商家。
4. **授权应用** — Clover 会带着一个代码将您重定向回 Pilotiko，该代码将换取一对令牌。
5. **检查卡片** — 卡片显示“已连接”，并提示不会执行任何自动操作。

## Clover 目前有哪些功能可用或即将推出？

| 功能 | 状态 | 详情 |
|---|---|---|
| 连接 Clover 商户账户 | 仅连接账户：目前没有任何自动操作 | 加密的令牌对 |
| 读取终端付款 | 即将推出 | 不调用 Clover 的 REST API |
| 读取订单和商品 | 即将推出 | 不导入任何内容 |
| 从 Pilotiko 发起退款 | 即将推出 | 需要经人工同意 |
| 在 Pilotiko 中撤销连接 | 可用 | 令牌已清除，并记入审计日志 |

## 一周的 Clover 交易会发生什么？

**示例：一家物理治疗诊所在 5 天内通过 Clover 处理了 64 笔交易**

诊所在前台的 Clover 终端上收取诊疗费用，而预约则在 Pilotiko 中管理。Clover 于周一完成连接。

- 终端交易（5 天） : 64
- Pilotiko 中已完成的预约 : 66
- Pilotiko 读取的交易 : 0
- 需要人工核对的差异（66 − 64） : 2 个预约没有可见的付款
- Pilotiko 办理的退款 : 0
- **= 66 个预约与 64 笔付款之间的核对仍需手动完成；Pilotiko 目前还不会进行核对。**

## Pilotiko 如何依据 Loi 25（魁北克隐私保护法）处理 Clover 访问权限？

令牌经过加密（AES-256-GCM），绝不会离开服务器。魁北克法律要求根据个人信息的敏感程度采取合理的安全措施，并要求同意须针对特定目的，且仅在必要期间有效 [4]。因此，Clover 连接是可选的、有说明的、可撤销的。

如果将来读取交易，根据所选的托管方式，这些交易可能会存储在魁北克以外；届时法律要求在向魁北克境外传输任何信息之前，先进行隐私因素评估 [4]。请参阅[安全](/securite)和[隐私](/confidentialite)。

撤销：Pilotiko 的“断开连接”按钮会清除令牌，并将该操作记入审计日志。至于 Clover 一侧，我们查阅的页面没有说明如何撤销应用授权；请在您的商户账户中核实，或联系 Clover 客服。

## Clover 连接有哪些限制？

Clover 令牌会过期：Clover 要求在当前令牌对过期之前生成新的一对 [2]。如果续期失败，卡片会变为“需重新连接”。Pilotiko 的 Clover 应用尚未注册。

作为对比：[Square](https://app.pilotiko.com/zh/integrations/square) 需要具名权限，[Stripe](https://app.pilotiko.com/zh/integrations/stripe) 通过 Connect 实现。这三者在[集成](https://app.pilotiko.com/zh/integrations)页面上的状态相同。关于需要核对的预约，请参阅[Google 日历](https://app.pilotiko.com/zh/integrations/google-calendar)。

## 常见问题

### Pilotiko 会读取我的 Clover 终端付款吗？

不会。连接已记录，但没有安排任何读取。您的交易仍保留在 Clover 中。

### 为什么发送给 Clover 的请求不包含任何权限范围？

Pilotiko 的代码没有传递任何权限范围：列表为空。由于目前该令牌不用于任何调用，因此 Pilotiko 并未因此获得任何实际的访问权限。

### Clover 授权会过期吗？

会。Clover 发放的一对令牌会过期，需要续期。如果续期失败，Pilotiko 会请您重新连接。

### 我们这边应该由谁来连接？

由能够登录商家 Clover 账户的人员完成，最好是所有者。该人员选择商家并授权应用。

### 如何撤销访问权限？

在 Pilotiko 中点击“断开连接”：令牌将被清除。若还要在 Clover 一侧切断访问，请通过您的 Clover 商户账户操作。

### Pilotiko 将来能通过 Clover 给客户退款吗？

目前不能。如果这项功能推出，每笔退款在发送给 Clover 之前都需要经过人工同意。

## 资料来源

1. Clover Developer Docs, « OAuth: introduction », https://docs.clover.com/dev/docs/oauth-intro (查阅于 2026-10-15)
2. Clover Developer Docs, « Use OAuth 2.0 », https://docs.clover.com/dev/docs/use-oauth (查阅于 2026-10-15)
3. RFC Editor (IETF), « RFC 6749 : The OAuth 2.0 Authorization Framework », https://www.rfc-editor.org/rfc/rfc6749 (查阅于 2026-10-15)
4. 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)
