Stripe 集成
将 Stripe 连接到 Frevana,即可查看账号数据并询问有关业务的问题。对于报告用途,受限只读密钥是不错的选择。
第 1 步:获取 API 密钥
登录 dashboard.stripe.com/apikeys,复制以 sk_live_ 或 sk_test_ 开头的 Secret key。
为了安全,我们建议使用受限密钥。选择 + Create restricted key,并按照以下步骤操作。
当系统询问“How will you use this API key?”时,选择 Building your own integration,然后选择 Continue。两个选项的实际工作方式相同,这只是 Stripe 的内部分类。
为密钥输入名称,例如 Frevana 或 AI Assistant。权限列表分为两列,每个资源类型可设置为 None / Read / Write:
| 列 | 用途 |
|---|---|
| Permissions | 访问您自己的 Stripe 账号。 |
| Connect Permissions | 访问已连接的账号(如果使用 Stripe Connect)。 |
在左侧 Permissions 列中,选择以下类别标题的 Read,即可一次设置其所有子项:
| 类别 | 设置为 | 用途 |
|---|---|---|
| Core | Read | 余额、付款、退款、客户。 |
| Billing | Read | 订阅、发票、产品、价格。 |
| Reporting | Read | 财务摘要,可选。 |
| 其他所有类别 | None | 不需要的权限保持关闭。 |
除非使用 Stripe Connect,否则右侧 Connect Permissions 均保持 None。请仅授予所需读取权限;即使是只读密钥也可能暴露敏感的业务和客户数据,因此请妥善保管。
选择页面底部的 Create key,然后复制以 rk_live_ 或 rk_test_ 开头的密钥。
第 2 步:在聊天中提供密钥
打开 Frevana,尝试发送:
Show me this month's revenue
如果 Stripe 尚未连接,Frevana 会要求您提供 secret key 或 restricted key。按提示提供即可。
不要粘贴 publishable key(pk_...)。AI 需要 Secret key(sk_...)或 Restricted key(rk_...)。
您可以做什么
| 类别 | 示例 |
|---|---|
| 收入 | “显示本月收入”“我的 Stripe 余额是多少?” |
| 失败付款 | “本周有失败的付款吗?” |
| 退款 | “列出过去 30 天的退款。” |
| 客户 | “列出最近的客户”“搜索 [email protected]”。 |
| 订阅 | “有多少活跃订阅者?”“显示所有逾期订阅。” |
| 产品 | “列出产品和价格”“显示 Pro 方案的价格。” |
| 发票 | “显示未结发票”“查找客户 X 的发票。” |
示例提问
- “显示本月收入。”
- “我当前的 Stripe 余额是多少?”
- “过去 7 天有失败的付款吗?”
- “查找电子邮件为 [email protected] 的客户。”
- “按状态汇总订阅情况。”
- “列出所有产品及其价格。”
- “显示所有未付款发票。”
测试模式与实时模式
- 以
sk_test_或rk_test_开头的密钥使用测试模式(沙盒数据,不产生真实扣款)。 - 以
sk_live_或rk_live_开头的密钥使用实时模式(真实数据)。
您可以随时粘贴不同的密钥进行切换。告诉 AI “Reconnect Stripe”即可更换密钥。
故障排查
“Invalid API key”:确保密钥以 sk_live_、sk_test_ 或 rk_ 开头,并从 Stripe API 密钥页面获取。
部分操作出现“Permission denied”:受限密钥缺少相应资源的读取权限。打开 Stripe API 密钥页面,找到受限密钥并选择铅笔图标编辑,滚动到 AI 提到的部分(例如 Core 或 Billing),将权限从 None 改为 Read,然后选择 Save。现有密钥会自动更新,无需重新粘贴。
切换账号或模式:告诉 AI “Reconnect Stripe”,然后粘贴新密钥。
隐私与安全
- API 密钥仅保存在本机(
~/.config/stripe/config.json)。 - AI 只读取数据,不会创建扣款、修改订阅或更改 Stripe 账号。
- 建议使用只读的受限密钥,以提高安全性。
- 您可以随时在 Stripe Dashboard 中撤销密钥。