查看类别

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

阅读时间:5分钟

Query Streams 将您的 Stripe 帐户连接到 Google Sheets,作为 SQL 可查询的表——客户、发票、订阅、费用等等,所有这些都可以通过标准 SQL 访问。 无需编写API程序,无需手动导出,无需处理CSV文件。只需编写SQL语句,即可在电子表格中获取实时Stripe数据。 在QueryStreams.com免费注册 并开始在几分钟内查询您的Stripe账户。

15条纹桌

客户、发票、订阅、费用、余额交易等

近实时

费用和支付意向每5分钟同步一次

AES-256加密

API密钥和缓存数据安全存储在您的网络中——绝不存放在云端

零API暴露

与团队成员共享收入报告,全程无需透露您的Stripe密钥

您可以访问哪些Stripe数据?

Query Streams 将您的 Stripe API 数据同步到 AES-256 加密本地缓存,并将其转换为 15 个可通过 SQL 查询的表。每个表包含: 原始数据 包含完整 Stripe API 响应的 JSON 列——包含所有元数据字段。

核心业务

  • 客户 包含计费信息和元数据的客户记录
  • 支付意图 现代支付流程追踪
  • 收据 账单记录及到期日
  • 订阅 定期计费订阅
  • 收费 支付费用(历史与当前)

财务与对账

  • 交易余额 完整账本(费用、支付、转账)
  • 退款 退还给客户的款项
  • 支付款项 银行转账追踪
  • 争议 拒付和欺诈案件

产品目录与价格

  • 产品 产品目录
  • 价格 定价层级与配置方案
  • 优惠券 折扣代码与促销活动

活动与详情

  • 活动 Webhook备份与审计追踪
  • 发票明细 明细项目计费详情
  • 订阅项目 多产品订阅细分

先决条件

1
查询流账户

免费注册 — 无需信用卡

2
查询流网络代理

已安装在您网络上的Windows服务。 安装指南

3
Stripe账户

任何具有API访问权限的Stripe账户(正式环境或测试环境)

4
Stripe 密钥

从...开始 sk_live_sk_test_ — 来自您的Stripe仪表盘

5
谷歌工作表

通过 Google Workspace 应用商店安装 Query Streams 附加组件

安装指南

1安装代理
2获取API密钥
3添加连接器
4同步计划
5安装附加组件

步骤 1:安装查询流网络代理

  1. 登录到 my.querystreams.com
  2. 导航至 网络代理 在左侧边栏
  3. 点击 下载代理 并运行 Windows 安装程序
  4. 该代理以Windows服务形式安装并自动连接。
  5. 您的代理将在30秒内于门户中显示为“在线”状态

网络代理创建安全的外发连接——无需开放防火墙端口,无需VPN。您的Stripe API密钥始终留在您的网络内。

步骤 2:获取您的 Stripe 密钥

  1. 登录您的 Stripe 仪表盘
  2. 点击 开发者 在顶部导航栏中
  3. 选择 API 密钥 从左侧边栏
  4. 复制你的 私钥 (以 sk_live_ 用于生产或 sk_test_ (用于测试)
  5. 请妥善保管此密钥——它可提供对您 Stripe 数据的完整读取权限

使用私钥,而非公钥。 可发布密钥(以 pk_无法验证 API 请求。Query Streams 仅执行读取操作——它永远不会修改您的 Stripe 数据。

步骤 3:添加 Stripe 连接器

  1. 在以下地址打开网络代理界面: http://localhost:1823
  2. 点击 添加连接 并选择 条纹
  3. 粘贴您的 秘密API密钥 输入到API密钥字段中
  4. 点击 测试连接 — Query Streams 使用 Stripe 验证您的密钥
  5. 成功后,您将看到帐户模式(正式帐户或测试帐户)的确认信息。
  6. 点击 下一页 继续同步配置

步骤4:配置同步计划

费用 / 付款意向每5分钟
发票 / 订阅每15分钟
客户 / 退款每15分钟
交易余额每30分钟
产品 / 价格按小时计费
事件 / 争议每日

默认情况下,所有15张表均处于同步状态。若需禁用某张表,请将其间隔时间设置为 永不点击 节省 — 初始同步将立即开始。

步骤 5:安装 Google 表格附加组件

  1. 在浏览器中打开 Google 表格
  2. 前往 扩展附加组件获取附加组件
  3. 搜索 “查询流”
  4. 点击 安装 并授予所需权限
  5. 通过以下方式访问: 扩展查询流打开
  6. 使用您的查询流账户凭据登录
  7. 或直接安装: 为 Google Sheets 安装查询流

你已连接! 在 Google 表格中打开查询流,点击 保存的查询找到包含预置查询的 Stripe 文件夹。选择任意查询并点击。 运行 将 Stripe 的实时数据导入到您的电子表格中。

示例 Stripe SQL 查询

月度收入摘要
SELECT
    DATE_TRUNC('month', created) AS 月份,
    COUNT(*) AS 交易次数,
    SUM(amount) / 100.0 AS 总收入,
    SUM(CASE WHEN 退款状态 = 'refunded' THEN 退款金额 ELSE 0 END) / 100.0 AS 退款金额,
    (SUM(金额) - SUM(CASE WHEN 退款状态 = '已退款' THEN 退款金额 ELSE 0 END)) / 100.0 AS 净收入
FROM stripe.charges
WHERE 状态 = '成功'
  AND 创建时间 >= CURRENT_DATE - INTERVAL '12 months'
GROUP BY DATE_TRUNC('month', 创建时间)
ORDER BY 月份 DESC;
按计划划分的有效订阅
SELECT
    p.name AS 产品名称,
    pr.nickname AS 套餐名称,
    pr.interval AS 计费周期,
    pr.unit_amount / 100.0 AS 单价,
    COUNT(s.id) AS 活跃订阅用户数,
    COUNT(s.id) * pr.unit_amount / 100.0 AS 经常性收入贡献额
FROM stripe.subscriptions s
JOIN stripe.subscription_items si ON si.subscription = s.id
JOIN stripe.prices pr ON pr.id = si.price
JOIN stripe.products p ON p.id = pr.product
WHERE s.status = 'active'
GROUP BY p.name, pr.nickname, pr.interval, pr.unit_amount
ORDER BY mrr_contribution DESC;
支付失败分析
SELECT
    DATE(created) AS date,
    failure_code,
    failure_message,
    COUNT(*) AS failure_count,
    SUM(amount) / 100.0 AS lost_revenue
FROM stripe.charges
WHERE status = 'failed'
  AND created >= CURRENT_DATE - INTERVAL '30 days'
GROUP BY DATE(created), failure_code, failure_message
ORDER BY date DESC, failure_count DESC;

共享Stripe报告而不共享凭据

在查询构建器中打开任何Stripe查询 → 点击 共享 tab → 输入队友邮箱地址 → 点击 共享收件人只会通过 Google Sheets 插件收到查询语句。他们可以按需运行该语句来获取实时数据——您的 Stripe API 密钥永远不会被泄露,他们也永远不会看到 SQL 代码。

常见问题

我能使用我的Stripe测试模式API密钥吗?
是的。查询流同时支持实时(sk_live_) 并测试 (sk_test_API密钥。测试模式非常适合在连接生产帐户之前评估集成情况。
费用和支付意图之间有什么区别?
费用代表单笔支付交易。支付意图是 Stripe 现代支付流程对象,用于跟踪完整的支付生命周期。对于历史报告,请使用费用;对于新的集成,请使用支付意图。
Query Streams 同步多少历史 Stripe 数据?
默认情况下,查询流会同步每个表的最新数据。您可以在连接器设置中调整回溯窗口。对于交易量较大的账户,初始同步可能需要几分钟时间。
我可以连接多个Stripe账户吗?
是的。您可以在单个代理中添加多个 Stripe 连接——每个连接使用不同的 API 密钥。每个连接在查询构建器中均显示为独立的数据源,使您能够在同一个 SQL 查询中查询和比较多个 Stripe 账户。

相关指南

类别:API 连接器

标签:Stripe、Google Sheets、API、支付数据、SQL、收入分析、订阅、实时数据

元描述:使用 SQL 将 Stripe 连接到 Google Sheets。实时查询客户、发票、订阅和费用——无需 API 编码。分步设置指南。

更新 2026 年 6 月 3 日

Powered by BetterDocs