Stripe 连接器
连接器状态: 已上线 已验证。Tajo 目前运行此连接器。
示意图 · 示例数据
同步示例
来源
Stripe
连接器状态: 已上线
目标
您的另一款工具
连接器状态: 自定义工具
字段映射
| 来源字段 | 目标字段 | 示例值 |
|---|---|---|
record.id | source_id | record_1042 |
record.updated_at | updated_at | 2026-10-18T08:00:00Z |
record.value | value | sample_value |
- 起草
- 检查一条记录
- 批准此版本
状态仅针对各个连接器，不保证此同步已就绪。 字段仅供示意。运行同步前，请检查实际架构和权限。
把你的 Stripe 账号连接到 Tajo，只读同步支付数据，包括客户、支付、订阅和发票，用于联系人归并、细分以及以营收为驱动的自动化（通过 Brevo 及其他互动服务商）。
概览
| 属性 | 值 |
|---|---|
| 认证 | Stripe secret key（sk_live_... / sk_test_...）或受限 key |
| 访问权限 | 只读，Tajo 绝不会向你的 Stripe 账号写入数据 |
| API 基础地址 | https://api.stripe.com/v1 |
| 同步方向 | Stripe → Tajo |
| 实时 webhook | 暂时没有，目前同步基于轮询 |
配置
- 在 Stripe Dashboard 中，打开 Developers → API keys。
- 创建一个受限 key：对 Customers、Charges、Subscriptions 和 Invoices 授予读取权限即可。相比完整的 secret key，强烈建议使用受限 key：Tajo 只做读取，因此只授予读取权限。
- 把这个 key 粘贴到 Tajo 的 Stripe 连接中。
在任何同步开始之前，连接都会先用一次只读请求完成校验。你可以随时在 Stripe 中轮换或撤销该 key。
会同步什么
| 数据 | Tajo 如何使用 |
|---|---|
| Customers | 归并为联系人（邮箱、姓名、手机号、地址），用于身份识别和细分。同意绝不会因为客户记录存在就被推断出来。 |
| Charges | 营收事件，用于基于购买的生命周期自动化和 LTV 细分 |
| Subscriptions | 生命周期状态（active、past_due、canceled 等），用于催款、赢回和留存流程 |
| Invoices | 支付状态，用于账单相关的消息触达 |
分页使用 Stripe 的游标模型（starting_after），因此大账号也能完整同步，中断后可以继续。
当前限制
坦率列出，方便你据此规划：
- 暂时没有实时 webhook。 变更按同步计划到达，而不是在一笔支付成功的那一刻。webhook 接入在路线图上。
- 只读。 Tajo 不会在 Stripe 中创建或修改客户、支付或订阅。
- 没有 Stripe App。 目前 Stripe App Marketplace 上还没有 Tajo 的 app；连接在 Tajo 中配置，而不是在 Stripe Dashboard 里。
故障排查
| 现象 | 原因与处理 |
|---|---|
| Stripe 返回 401 | key 已被撤销或轮换，请把当前的 key 粘贴到连接中 |
| 客户能同步，charges 不能 | 受限 key 缺少对 Charges 的读取权限 |
| 联系人没有邮箱 | 没有邮箱的 Stripe 客户会同步为匿名营收记录；之后补上邮箱，他们就会并入联系人图谱 |
后续步骤
- 客户同步：把 Stripe 客户映射到你的记录系统
- 在 Tajo 中基于订阅状态变化搭建催款和赢回自动化