跳到主要内容

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,即可一次设置其所有子项:

类别设置为用途
CoreRead余额、付款、退款、客户。
BillingRead订阅、发票、产品、价格。
ReportingRead财务摘要,可选。
其他所有类别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 中撤销密钥。