# Stripe 与 Pilotiko：连接您的收款账户

> 将您的 Stripe 账户连接到 Pilotiko：详解 OAuth read_write 授权范围，说明目前已接入和尚未接入的功能，并介绍如何随时撤销访问权限，让您对 Stripe 对接的每一步都清楚放心。

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

目前，Pilotiko 可以通过 Stripe Connect（OAuth，read_write 授权范围）连接您的 Stripe 账户，但尚未使用它：没有收款，不读取支付数据，也没有退款。状态：仅连接账户：暂时没有任何自动操作。您的客户仍照常付款。

## 要点
- 状态：仅连接账户：暂时没有任何自动操作。
- 访问请求：Stripe Connect，授权范围为 **read_write**，不使用 PKCE。
- 未接入任何操作：没有支付，不读取交易，也没有退款。
- 该账户与 Pilotiko 用来收取自身订阅费的 Stripe 毫无关系。
- 您可以在 Pilotiko 一键撤销访问权限，也可以在 Stripe 端撤销。

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

它以贵公司的名义保存一项 Stripe Connect 授权，目前不会在您的账户上触发任何操作。

在 Pilotiko 的功能清单中，Stripe 归在「收款」（由客户向您付款）类别下，状态为**仅连接**。具体来说，授权流程是可用的：您点击「连接」，Stripe 请您批准 Pilotiko，随后 Pilotiko 保存收到的令牌。之后产品中没有任何功能使用它。

请求通过 Stripe Connect 的授权地址发出，授权范围为 **read_write**。Stripe 的文档列出两个可选值：read_write 和 read_only，并说明 read_only 只能由扩展程序请求 [1]。Stripe 返回的授权码 5 分钟后过期，且只能使用一次 [1]。整个流程遵循 OAuth 2.0 框架：您绝不会把 Stripe 密码交给 Pilotiko [2]。

为什么要连接一个暂时还用不上的账户？因为等到收款功能接入的那一天，您的授权已经就位，Pilotiko 也知道是哪个账户代表公司发言。在此之前，「连接」页面会清楚显示「可以连接，但 Pilotiko 尚未使用」。

- **read_write**：Stripe 授予 Connect 平台的访问级别。Pilotiko 会请求该权限，但不会用它调用任何支付 API。
- **目前读取的数据**：无。Pilotiko 不查看您的余额、Stripe 客户或转账记录。
- **目前写入的数据**：无。不创建支付，不退款，也不生成付款链接。
- **需要批准的事项**：未来任何收款或退款都会涉及资金，必须由人工批准，与 Pilotiko 中所有涉及客户或资金的操作一样。

## 如何把 Stripe 连接到 Pilotiko？

连接无需复制任何密钥。如果您的账户上还看不到该按钮，说明 Pilotiko 尚未启用 Stripe 应用：页面会如实告知，而不会显示一个虚假的按钮。

1. **打开「连接」页面** — 在 Pilotiko 中打开「连接」，找到「收款」组里的 Stripe 卡片。
2. **点击「连接」** — Pilotiko 会生成一个一次性的「state」参数，与您的企业和用户绑定，有效期 10 分钟。
3. **在 Stripe 端批准** — 登录 Stripe，并以您公司的名义同意 read_write 访问请求。
4. **返回 Pilotiko** — Pilotiko 校验「state」，兑换授权码（在 Stripe 的有效期为 5 分钟），并对收到的令牌加密。
5. **检查状态** — 卡片显示「已连接」，并提醒目前不会执行任何自动操作。

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

| 功能 | 状态 | 说明 |
|---|---|---|
| 连接您的 Stripe 账户（OAuth Connect） | 仅连接账户：暂时没有任何自动操作 | read_write 授权已保存并加密 |
| 用银行卡向客户收款 | 即将推出 | 尚未构建任何支付调用 |
| 读取您的 Stripe 支付和客户数据 | 即将推出 | 不进行任何读取 |
| 退款 | 即将推出 | 需经人工同意 |
| 断开连接（Pilotiko 端） | 可用 | 令牌已清除，操作记入审计日志 |

为 Pilotiko 订阅收费的 Stripe 属于 Pilotiko：那是另一个账户，与您的账户没有任何关联。

## 连接 Stripe 后，一周的付款情况是怎样的？

**示例：一家维修店一周内收到 18 笔 Stripe 付款**

这家维修店周一把 Stripe 连接到了 Pilotiko。一周内，客户通过它原本就在使用的 Stripe 链接支付了 18 张发票。以下是 Pilotiko 目前对这些付款的处理方式。

- Stripe 中收到的付款 : 18
- Stripe 中收取的总金额 : 2 340 $
- Pilotiko 读取的付款 : 0
- Pilotiko 创建或退款的付款 : 0
- 需要在 Pilotiko 中手动核对的发票 : 18
- **= 这 18 笔付款完全在 Stripe 中处理，Pilotiko 不会触碰。**

## Pilotiko 如何保护 Stripe 访问权限（Loi 25）？

Stripe 令牌采用 AES-256-GCM 静态加密，绝不离开服务器，也不会出现在任何日志中。《私营部门个人信息保护法》（Loi sur la protection des renseignements personnels dans le secteur privé）要求同意必须明确、自愿、知情且针对特定目的，并且只在必要期限内有效 [3]。因此，连接 Stripe 是一项自愿行为，卡片上有说明，您可以随时撤销。

该法第 8 条规定，须告知当事人收集信息的目的及其撤回同意的权利 [3]。魁北克信息获取委员会（Commission d'accès à l'information）也总结了自 2023 年 9 月起更严格的同意规定 [4]。请参阅我们的[隐私政策](/confidentialite)和[安全](/securite)页面。

撤销访问权限：在 Pilotiko，点击「断开连接」按钮会清除令牌，并将该操作记入审计日志。在 Stripe 端，可以取消平台授权；Stripe 的文档说明了 /oauth/deauthorize 调用，以及在控制台中移除已连接账户（「Remove account」）的方法，此后平台将无法再访问该账户 [1]。

## Stripe 连接有哪些限制？

Stripe 表示，自 2021 年 6 月起，使用 read_write 的 OAuth 平台无法连接已由其他平台控制的账户 [1]。如果您的 Stripe 账户是由控制它的其他软件创建的，连接可能会被拒绝。

Pilotiko 针对 Stripe 的 OAuth 应用尚未注册。如需线下当面收款，请参阅状态相同的 [Square](https://app.pilotiko.com/zh/integrations/square) 或 [Clover](https://app.pilotiko.com/zh/integrations/clover)。按状态分类的完整列表见[集成](https://app.pilotiko.com/zh/integrations)页面；如需在社交网络发布内容，请参阅 [LinkedIn](https://app.pilotiko.com/zh/integrations/linkedin)。

## 常见问题

### Pilotiko 可以用 Stripe 向我的客户收款吗？

目前还不行。连接只是保存您的授权，Pilotiko 不会创建任何支付。您的客户仍像以前一样，直接在 Stripe 中付款。

### 为什么 Pilotiko 请求 read_write 而不是 read_only？

Stripe 将 read_only 授权范围保留给扩展程序；Connect 平台请求的是 read_write。不过 Pilotiko 目前并未使用其中任何一项权限。

### 这和我的 Pilotiko 订阅所用的 Stripe 是同一个吗？

不是。Pilotiko 使用自己的 Stripe 账户收取订阅费。您的账户保持独立，Pilotiko 绝不会把两者混在一起。

### 如何撤销 Pilotiko 对我的 Stripe 账户的访问权限？

在「连接」页面点击「断开连接」：令牌会被清除，操作记入审计日志。您也可以在 Stripe 端移除该平台。

### Pilotiko 能看到我的 Stripe 余额或转账记录吗？

不能。没有接入任何读取功能：Pilotiko 不查看余额、客户或转账记录。

### 等收款功能接入后会怎样？

页面和 Stripe 卡片的状态会随之变化。代理提议的任何支付或退款，都要先经人工同意才会执行。

## 资料来源

1. Stripe Docs, « Connect OAuth reference », https://docs.stripe.com/connect/oauth-reference (查阅于 2026-10-15)
2. RFC Editor (IETF), « RFC 6749 : The OAuth 2.0 Authorization Framework », https://www.rfc-editor.org/rfc/rfc6749 (查阅于 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)
