---
title: "Stripe 连接器"
description: "用受限 API key 把 Stripe 连接到 Tajo，只读同步客户、支付、订阅和发票数据，供互动与迁移流程使用。"
url: https://tajo.io/zh-cn/docs/connectors/ecommerce/stripe/
markdown: https://tajo.io/zh-cn/docs/connectors/ecommerce/stripe.md
lang: zh-CN
robots: noindex
---

申请抢先体验

请输入您的名字和公司电子邮箱地址。我们会发送确认 Tajo 访问申请的链接。

# Stripe 连接器

连接器状态: 已上线 已验证。Tajo 目前运行此连接器。

| 来源字段 | 目标字段 | 示例值 |
| --- | --- | --- |
| `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 | 暂时没有，目前同步基于轮询 |

## 配置

1. 在 Stripe Dashboard 中，打开 **Developers → API keys**。
2. 创建一个**受限 key**：对 **Customers**、**Charges**、**Subscriptions** 和 **Invoices** 授予读取权限即可。相比完整的 secret key，强烈建议使用受限 key：Tajo 只做读取，因此只授予读取权限。
3. 把这个 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 客户会同步为匿名营收记录；之后补上邮箱，他们就会并入联系人图谱 |

## 后续步骤

- [客户同步](https://tajo.io/zh-cn/docs/skills/data-sync/customer-sync/)：把 Stripe 客户映射到你的记录系统
- 在 Tajo 中基于订阅状态变化搭建催款和赢回自动化