如何将 Stripe 连接到 Excel - 使用 SQL 查询付款数据

连接 · Stripe 到 Excel

从以下来源获取数据 条纹 进入 在 Excel

将 Stripe 账户中的实时数据导入 Excel，并随时刷新。无需 ODBC 驱动程序、导出功能或宏。首次设置大约需要十分钟，免费套餐即可满足所有需求。

大约10分钟 无需编程 凭证将一直随您保留 随时随地，甚至在网页上，都能轻松使用 Excel

你最终会得到什么

一个工作表，实时显示针对您的 Stripe 账户执行的 SQL 查询结果，并带有一个按钮，可在数据更改时自动更新最新行。例如：

销售.xlsx — Excel

首页插入数据查询流

	A	B	C	D	E
1	customer_id	名	姓	国家	总计
2	1042	玛丽亚	阿尔瓦雷斯	美国	1,284.50
3	1043	丹尼尔	奥卡福	美国	612.00
4	1047	普里亚	奈尔	美国	2,090.75
5	1051	托马斯	伯格	美国	338.20
6	1056	露西亚	费雷拉	美国	1,455.00
7	1060	健二	佐藤	美国	874.10
8

工作表1 Stripe 现场直播

Stripe 将您的数据存储在其 API 之后。通常，每次需要新数据时，您都需要从 Stripe 控制面板导出 CSV 文件才能将其导入 Excel。Query Streams 则简化了这一步骤：一个名为 Agent 的小型辅助程序会在您的数据所在位置运行查询，然后 Excel 加载项会请求您所需的行。只有查询结果会通过加密链接传输，因此 Excel 可以位于任何地方：您家里的笔记本电脑、远在异地的同事的电脑，或者网页版 Excel。

你需要准备什么

查询流帐户

免费版足以满足本指南的需求。请注册： my.querystreams.com.

任何始终在线的计算机上的代理

这是一个在后台运行的小程序，当 Excel 发出请求时，它会调用 Stripe。它只需要联网即可。

您的 Stripe 登录信息

您只需登录 Stripe 一次并授予读取权限。查询流中无需输入任何密码。

分五步连接

1. 创建您的帐户

   前往 my.querystreams.com 并注册。选择 免费 方案。这是一个正式的方案，不是试用版，它涵盖了连接您的 Stripe 账户以及如何从 Excel 运行查询。

2. 在任何始终开机的计算机上安装代理程序。

   登录，打开 下载然后将代理程序安装到任何始终在线且可访问互联网的计算机或服务器上。安装只需一分钟，安装完成后即可自动启动。

   为什么使用小型程序而不是驱动程序？ 该代理程序只需在 Windows、Mac 或 Linux 系统上安装一次（Windows 系统下约 85 MB，Mac 和 Linux 系统下略超过 100 MB），即可在后台静默运行。它会像浏览器一样，与 Query Streams 建立一条加密的出站连接，因此您无需打开任何防火墙端口或设置 VPN。您的密钥保留在本地计算机上，数据行会传输到您所在的任何位置，必要时甚至会通过互联网传输。您这边只需要安装该插件即可。

   下载页面显示 您的访问密钥当代理提示时，将其粘贴到代理中，然后等待徽章读取。 已连接到查询流这是你在代理程序本身上唯一需要做的事情。

   完整攻略（如果您需要）： Windows, 苹果, Linux.

3. 指向您的 Stripe 账户

   返回浏览器，打开 数据代理 （在下面 数据 （在顶部菜单中）。您的经纪人信息就在那里。点击 添加连接器 并选择 条纹需要先输入您的 Stripe 凭证吗？打开操作指南，然后填写：

   创建您的 Stripe 凭证 （约8分钟）

   接下来，在另一个标签页打开 Stripe。Query Streams 会保存您在此处创建的内容，以便您的代理可以使用它，并且它只会从 Stripe 读取数据。

   谁能做到这一点？

   账户所有者、超级管理员、管理员或开发者（Stripe 中可以创建 API 密钥的角色）

   受到推崇的

   具有只读权限的受限 API 密钥（rk_live_… 用于实时数据，rk_test_… 用于沙箱环境）

   开始之前

   • 需要使用 Stripe 登录，且拥有账户所有者、超级管理员、管理员或开发者角色。其他角色（例如分析师、仅查看者、支持人员等）无法创建 API 密钥。
   • Stripe 会通过电子邮件或手机向您发送验证码。Stripe 会在创建密钥之前要求您提供验证码。
   • 查询流向导会在另一个标签页中打开（数据代理 → 添加连接器 → Stripe），此时您的代理已在线，因此您可以在 Stripe 显示密钥后立即粘贴密钥。

   步骤

   1. 登录并选择实时数据或沙盒环境

      登录 Stripe 控制面板。Stripe 将真实数据和沙盒（测试）数据分开存储，两者各自拥有独立的密钥。对于您的真实支付，请在您的企业账户中操作，不要在沙盒中操作。要使用测试数据，请打开控制面板的账户选择器，点击“沙盒”，然后打开您需要的沙盒。

      活动密钥无法读取沙盒数据，沙盒密钥也无法读取活动数据。如果您需要同时使用两者，请在活动密钥和沙盒密钥中各创建一个密钥，并将每个密钥作为独立的 Stripe 连接器添加到查询流中。

   2. 打开 API 密钥页面

      打开 API 密钥页面。您也可以在控制面板中点击“开发者”（左下角），然后选择“API 密钥”。该页面包含两个列表：标准密钥（可发布密钥和私钥）和受限密钥。

      使用沙盒环境？请先打开沙盒环境（步骤 1）。每个沙盒环境都有自己的 API 密钥页面和密钥。

   3. 启动受限密钥

      在“受限密钥”列表中，单击“创建受限密钥”。某些帐户可能显示为“+ 创建受限密钥”。

      请勿使用可公开密钥（pk_…）。它无法读取账户数据。私钥（sk_…）也适用于查询流，但它可以对您的账户执行任何操作，包括退款和付款。Stripe 建议使用受限密钥，而查询流只需要读取权限。

   4. 说明钥匙将如何使用

      Stripe会询问您将如何使用该密钥。选择“构建您自己的集成”，然后单击“继续”。

      请勿选择“授权代理访问您的帐户”。该选项会将密钥标记为 AI 代理可用，并添加 Stripe 的审批规则。如果您误选了“将此密钥提供给其他网站”，请在下一个屏幕上勾选“自定义此密钥的权限”。如果您不勾选，Stripe 将赋予密钥默认权限，而不是步骤 7 中的只读权限列表。

   5. 从无权限开始

      Stripe 提供现成的权限模板，或者您可以选择从零开始创建权限。您可以选择从零开始（自行选择权限），这样所有权限最初都为“无”。

      Stripe 会经常更改此屏幕上的文字。请查找类似“从头开始”或“选择我自己的”之类的选项，而不是模板。如果找不到此屏幕，请直接跳至步骤 6。

   6. 命名密钥

      在“键名”中，输入一个您以后能够识别的名称，例如“查询流（只读）”。

   7. 设置对 13 个资源的读取权限 查询流同步

      每个资源行都有三个选项：无、读取和写入。请在以下 13 行中选择“读取”，其余行保持“无”状态。核心部分包括：余额、余额交易来源、费用和退款、客户、争议、事件、付款意向、付款、产品。计费部分包括：优惠券、发票、价格、订阅。要快速查找某行，请按 Ctrl+F（Mac 上为 Cmd+F）并输入其名称的首字母。

      切勿选择“写入”。Query Streams 仅支持读取，因此即使存在数据泄露，仅具有“读取”权限的键也无法创建费用、退款或付款。即使您从未同步事件表，也需要启用“事件”功能，因为 Query Streams 会读取 Stripe 的事件列表以获取同步之间的更改。如果您使用 Connect，请将连接帐户权限设置为“无”。如果行名称与您看到的内容不符，请点击“所有核心资源”和“所有计费资源”标题行上的“读取”按钮。该键仍然是只读的，但其读取权限比 Query Streams 使用的权限更高。

   8. 创建密钥

      点击“创建密钥”。

   9. 请输入验证码

      Stripe 会通过电子邮件或短信发送验证码。请在对话框中输入验证码。如果对话框没有自动继续，请点击“继续”。

      没有收到验证码？请检查垃圾邮件，或查看您 Stripe 个人资料中的电话号码。

   10. 复制密钥

       Stripe 现在会显示新密钥。它以 rk_live_ 开头（在沙盒环境中可能是 rk_test_）。单击密钥值即可复制，然后将其直接粘贴到“查询流”向导中的“Stripe 密钥”字段。

       在正式模式下，Stripe 只会显示您创建的密钥一次，之后无法再次显示。沙盒密钥可以随时显示。请勿通过电子邮件或聊天发送密钥。Query Streams 会将密钥存储在您的代理系统中，并且只能通过该代理系统读取密钥。

   11. 注意键的使用位置

       在“添加备注”中，输入密钥的使用位置，例如“办公电脑上的 Query Streams Agent”。然后单击“完成”。该密钥现在会出现在“受限密钥”列表中。

       每当您或同事稍后查看密钥时，都会显示此备注，因此不会有人意外地使此密钥过期。

   授予权限

   资源	访问	用于
   客户	读	客户表。测试连接也会先读取该表。
   费用和退款	读	费用和退款表格。一行涵盖两者，没有单独的退款行。
   付款意向	读	payment_intents 表
   发票	读	发票表和发票项目表。发票项目本身没有单独的行。
   订阅	读	subscriptions 和 subscription_items 表
   平衡	读	balance_transactions 表（Stripe 的余额交易列表，以前称为余额历史记录）
   余额交易来源	读	balance_transactions 表：允许每笔交易链接到其背后的收款、退款或付款。Stripe 表示，这也授予了对余额和付款的读取权限。
   派息	读	赔付表
   争议	读	争议表
   产品	读	产品表
   价格	读	价格表
   优惠券	读	优惠券表格
   活动	读	事件表，以及用于在同步之间保持客户、订阅、发票、发票项目、费用、付款意向、退款、争议、付款、产品、价格和优惠券等信息的变更源。

   粘贴到查询流中

   条纹密钥

   您在步骤 10 中复制的受限密钥（以 rk_live_ 或 rk_test_ 开头）。私钥（sk_live_ 或 sk_test_）也可以，但它的功能远不止读取。

   常见问题

   测试连接失败，提示 API 密钥无效。

   为什么： 复制时遗漏了部分密钥，添加了空格，粘贴了可发布的密钥（pk_…），或者有人在 Stripe 中使密钥过期或轮换。

   使固定： 密钥必须以 rk_ 或 sk_ 开头。请再次粘贴，密钥前后不要有任何内容。如果您不再拥有该密钥（Stripe 只显示一次有效密钥），请创建一个新的受限密钥（步骤 3 至 11），然后粘贴该密钥。

   测试连接显示“已连接”，但部分表仍然为空，且同步时出现 Stripe 权限错误 (403)。较新版本的 Agent 还会在测试连接下方显示一条警告，指出哪些表的键无法读取。

   为什么： 该表的某一行缺少读取权限。Stripe 的错误信息会指出缺失的权限，例如 rak_event_read 表示事件读取权限。

   使固定： 在 Stripe API 密钥页面，点击密钥旁边的“⋯”菜单，选择“编辑密钥”，将缺失的行设置为“读取”，然后保存。密钥本身不会改变，因此无需再次粘贴任何内容。在“查询流”中再次点击“测试连接”。

   已连接，但您只能看到测试数据，或者即使您收到实际付款，表格也是空的。

   为什么： 关键在于，当你需要实时数据时，可以使用沙箱（rk_test_），反之亦然。

   使固定： 检查密钥的起始位置。对于正式数据，请使用账户选择器退出沙盒环境，重新创建密钥（步骤 2 至 11），然后在数据代理中打开连接器，点击“编辑”，并将密钥粘贴到 Stripe 密钥中。请将测试连接器和正式连接器分开。

   之前可以正常工作的连接器现在停止同步，提示 API 密钥无效。

   为什么： 有人在 Stripe 中轮换或注销了密钥。轮换后的密钥仅在轮换时设定的有效期内有效，最长为 7 天。

   使固定： 创建一个新的受限密钥，或者从轮换密钥中复制替换密钥。在“查询流”中，打开连接器，点击“编辑”，将密钥粘贴到“Stripe 密钥”字段，点击“测试连接”，然后点击“保存”。

   您看不到“创建受限密钥”选项，或者 API 密钥页面将无法打开。

   为什么： 您的 Stripe 角色无法管理 API 密钥。分析师、仅查看者和支持人员角色均无法管理 API 密钥。

   使固定： 请您的 Stripe 账户所有者、管理员或开发人员为您创建密钥，或者更改您的角色。

   Stripe 会通过电子邮件通知您它阻止了某个请求，即使密钥正确，同步也会失败。

   为什么： 密钥上的访问策略（IP 地址或高级）不允许代理计算机的互联网地址，或者阻止计算机使用的 VPN 或代理。

   使固定： 在 API 密钥页面上，单击密钥旁边的“⋯”，选择“管理访问策略”，然后选择允许代理计算机公共 IP 地址的策略或选择“无”。然后单击“保存”。

   密钥已泄露（通过电子邮件或聊天发送，或保存在共享文件中），或者拥有密钥的人员已离开您的团队。

   为什么： 任何持有该密钥的人都可以读取其权限范围内的所有内容。

   使固定： 在 API 密钥页面，点击密钥旁边的“⋯”图标，然后选择“轮换密钥”。在“过期时间”中，选择“立即”以立即删除旧密钥，然后点击“轮换 API 密钥”。复制新密钥，并将其粘贴到连接器中（编辑 → Stripe 密钥 → 测试连接 → 保存）。

   您希望 Query Streams 停止读取此 Stripe 帐户。

   为什么： 删除连接器不会禁用密钥。密钥在 Stripe 中仍然有效，直到您将其过期为止。

   使固定： 在 API 密钥页面，点击密钥旁边的“⋯”，选择“密钥过期”，然后再次点击“密钥过期”进行确认。之后，在数据代理中删除该连接器。

   需要了解的界限

   • 事件数据可追溯至 30 天前。Stripe 的事件列表仅追溯至 30 天前，因此事件表中的数据永远不会超过最近 30 天。查询流也会读取事件数据以获取同步之间的更改，因此如果某个连接器关闭超过大约四周，则其下一次同步会再次完整读取其表。
   • 请求速度：Stripe 在正式模式下允许每秒 100 个 API 请求，在沙盒模式下允许每秒 25 个请求，大多数独立端点也允许每秒 25 个请求。每个请求最多返回 100 条记录，因此首次同步 100 万笔交易大约需要 1 万个请求，按每秒 25 个请求的速度计算，大约需要 7 分钟。沙盒同步速度较慢。
   • 每月读取限额：Stripe 要求账户在过去 30 天内的平均每笔交易读取请求不超过 500 次，每月最低为 10,000 次。每个启用的表每次同步时至少会发出一个请求，因此对于新账户或交易量较低的账户，请为不需要每分钟同步的表设置更长的同步间隔。
   • 每个密钥只能读取它创建时的模式（实时模式或特定的沙箱模式）。
   • 连接：该密钥仅读取您自己账户中的对象。已连接账户的付款不会同步。
   • 再次显示密钥：Stripe 只会显示您创建的正式密钥一次，而沙盒密钥可以随时显示。当您轮换密钥时，旧密钥最多可以继续使用 7 天。

   步骤已于2026年10月8日核实。来源： docs.stripe.com/keys, docs.stripe.com/keys/restricted-api-keys, docs.stripe.com/keys-best-practices, docs.stripe.com/stripe-apps/reference/permissions, docs.stripe.com/sandboxes, docs.stripe.com/testing-use-cases, docs.stripe.com/rate-limits, docs.stripe.com/api/events/list, docs.stripe.com/api/balance_transactions/list, docs.stripe.com/api/errors, docs.stripe.com/get-started/account/teams/roles, docs.stripe.com/workbench, support.stripe.com/questions/plugin-user-migration-guide, stripe.com/sessions/2026/building-security-first-stripe, posthog.com/docs/cdp/sources/stripe, help.chaserhq.com/use-chaser-with-stripe, homerunner.io/docs/creating-stripe-restrict-key-for-homer…, chargebee.com/docs/reveal/transactions/get-started/stripe…, nango.dev/docs/api-integrations/stripe-api-key/connect, fivetran.com/docs/connectors/applications/stripe/troubles….

   连接名称

   任何你以后会记住的名称，例如销售数据库。

   条纹密钥

   您的 Stripe 密钥位于 Stripe 控制面板的“开发者”>“API 密钥”下；它以 sk_live_ 或 sk_test_ 开头。

   点击 测试连接当它读到 已连接， 点击 节省连接会在几秒钟内到达您的代理。

   开放数据代理

   测试失败？ 通常是由于缺少权限，或者使用了错误的 Stripe 账户的凭证。上面的步骤详述了以下内容： 常见问题 以及他们的解决方案。

4. 将查询流添加到 Excel

   在 Excel 中，转到 插入 → 获取加载项搜索 查询流然后点击 添加或者直接从……打开 在 Microsoft AppSource 上查询流功能区上会出现“查询流”按钮。请使用同一帐户登录。

   适用于 Windows 和 Mac 上的 Microsoft 365 Excel 以及网页版 Excel。

5. 把你的第一张桌子拉过来

   点击“查询流”按钮，选择 流式查询然后选择你刚刚建立的连接。

   输入要运行的查询语句。以下查询语句会从数据库中提取几列数据。 stripe.invoices 桌子：

   示例 · SQL

   SELECT number, status, amount_due / 100.0 AS amount_due, currency FROM stripe.invoices ORDER BY created DESC LIMIT 100;

   在下面 目的地表 选择 创建新工作表然后按下播放按钮（▶ 箭头）。数据行会在一两秒钟内显示在 Excel 表格中。如果数据发生更改，请再次按下该按钮，表格将自动更新。

   不懂SQL？ 请改在 Query Streams 门户中构建查询。 查询生成器 它会显示您的表格和列，方便您进行点击操作。在商业版套餐中，您还可以用简单的英语向 Nova 提问（例如“显示美国的客户”），它会自动为您生成 SQL 查询语句。保存查询后，您只需在门户网站或个人版及更高版本的插件的“已保存查询”列表中单击一下即可访问该查询。

下一步行动不错。

• 保存查询 在门户网站上，您可以一键再次运行它，也可以从 Excel 或 Google Sheets 运行。
• 添加筛选器 例如日期范围，这样同一个查询就可以回答“本月”而无需编辑。
• 分享结果 与同事一起操作。他们看到的是行，而不是你的凭证。

人们提出的问题

相关指南

• Stripe 到 Google 表格
• HubSpot 到 Microsoft Excel
• Shopify 到 Microsoft Excel
• Google Analytics 4 到 Microsoft Excel
• 在 Excel 中运行 SQL
• 所有指南