Ver categorias

Como conectar o Stripe ao Google Sheets - Consultar dados de pagamento com SQL

5 minutos de leitura

O Query Streams conecta sua conta Stripe ao Google Sheets como tabelas consultáveis por SQL — clientes, faturas, assinaturas, cobranças e muito mais, tudo acessível com SQL padrão. Sem programação de API, sem exportações manuais, sem manipulação de CSV. Basta escrever SQL e obter dados Stripe em tempo real na sua planilha. Inscreva-se gratuitamente em QueryStreams.com e comece a consultar sua conta Stripe em poucos minutos.

15 Tabelas Stripe

Clientes, faturas, assinaturas, cobranças, transações de saldo e muito mais

Quase em tempo real

As cobranças e as intenções de pagamento são sincronizadas a cada 5 minutos.

Criptografado com AES-256

Chaves API e dados em cache armazenados com segurança na sua rede — nunca na nuvem

Exposição zero da API

Compartilhe relatórios de receita com colegas de equipe sem nunca revelar sua chave Stripe

A quais dados do Stripe você pode acessar?

O Query Streams sincroniza os dados da API do Stripe com um cache local criptografado com AES-256, transformando-os em 15 tabelas consultáveis por SQL. Cada tabela inclui um dados brutos Coluna JSON com a resposta completa da API Stripe, incluindo todos os campos de metadados.

Negócio principal

  • clientes Registros de clientes com informações de faturamento e metadados
  • intenções de pagamento Rastreamento moderno do fluxo de pagamentos
  • faturas Registros de faturamento e datas de vencimento
  • assinaturas Assinaturas com cobrança recorrente
  • encargos Taxas de pagamento (antigas e atuais)

Finanças e reconciliação

  • transações de saldo Livro-razão completo (taxas, pagamentos, transferências)
  • reembolsos Dinheiro devolvido aos clientes
  • pagamentos Rastreamento de transferências bancárias
  • disputas Estornos e casos de fraude

Catálogo e preços

  • produtos Catálogo de produtos
  • preços Níveis de preços e configurações
  • cupons Códigos de desconto e promoções

Atividade e detalhes

  • eventos Backup de webhook e trilha de auditoria
  • itens_da_fatura Detalhes da faturação por item
  • itens_de_assinatura Discriminação de assinaturas de vários produtos

Pré-requisitos

1
Conta de fluxos de consulta

Inscreva-se gratuitamente — não é necessário cartão de crédito

2
Agente de rede de fluxos de consulta

Serviço Windows instalado na sua rede. Guia de instalação

3
Conta Stripe

Qualquer conta Stripe com acesso à API (modo ao vivo ou de teste)

4
Chave secreta da API do Stripe

Começa com sk_live_ ou sk_test_ — a partir do seu Painel do Stripe

5
Planilhas Google

Com o complemento Query Streams instalado a partir do Google Workspace Marketplace

Guia de configuração

1Instalar o agente
2Obter chave API
3Adicionar conector
4Agenda de sincronização
5Instalar complemento

Etapa 1: Instalar o Query Streams Network Agent

  1. Faça login em my.querystreams.com
  2. Navegue até Agentes de rede na barra lateral esquerda
  3. Clique em Baixar Agente e execute o instalador do Windows
  4. O agente é instalado como um serviço do Windows e se conecta automaticamente.
  5. Seu agente aparece como “Online” no portal em 30 segundos

O Network Agent cria uma conexão segura, apenas de saída — sem portas de firewall de entrada, sem necessidade de VPN. Sua chave API do Stripe nunca sai da sua rede.

Passo 2: Obtenha sua chave API secreta do Stripe

  1. Faça login na sua conta Painel do Stripe
  2. Clique em Desenvolvedores na navegação superior
  3. Selecionar Chaves de API da barra lateral esquerda
  4. Copie o seu Chave secreta (começa com sk_live_ para produção ou sk_test_ para teste)
  5. Mantenha esta chave em segurança — ela fornece acesso total de leitura aos seus dados do Stripe.

Use a chave secreta, não a chave publicável. A chave publicável (começando com pk_) não pode autenticar solicitações de API. O Query Streams realiza apenas operações de leitura — ele nunca modifica seus dados do Stripe.

Etapa 3: Adicione o conector Stripe

  1. Abra a interface do Agente de Rede em http://localhost:1823
  2. Clique em Adicionar conexão e selecione Listrado
  3. Cole seu Chave API secreta no campo Chave API
  4. Clique em Conexão de teste — O Query Streams valida sua chave com o Stripe.
  5. Após a conclusão bem-sucedida, você verá a confirmação do modo da sua conta (Real ou Teste).
  6. Clique em Próximo para prosseguir com a sincronização da configuração

Etapa 4: Configure sua programação de sincronização

Cobranças / Intenções de pagamentoA cada 5 minutos
Faturas / AssinaturasA cada 15 minutos
Clientes / ReembolsosA cada 15 minutos
Transações de saldoA cada 30 minutos
Produtos / PreçosPor hora
Eventos / DisputasDiariamente

Todas as 15 tabelas são sincronizadas por padrão. Desative qualquer tabela definindo seu intervalo como Nunca. Clique Salvar — a sincronização inicial começa imediatamente.

Etapa 5: Instale o complemento do Google Sheets

  1. Abra o Google Sheets no seu navegador
  2. Vá para ExtensõesComplementosObter complementos
  3. Pesquisar por “Fluxos de consultas”
  4. Clique em Instalar e conceda as permissões necessárias
  5. Acesse através de ExtensõesFluxos de consultaAberto
  6. Faça login com as credenciais da sua conta Query Streams.
  7. Ou instale diretamente: Instalar fluxos de consulta para o Planilhas Google

Você está conectado! Abra Fluxos de consulta no Google Sheets, clique em Consultas salvase encontre sua pasta do Stripe com as consultas pré-configuradas. Selecione qualquer consulta e clique em Executar Para importar dados do Stripe em tempo real para sua planilha.

Exemplos de consultas SQL do Stripe

Resumo mensal da receita
SELECT
    DATE_TRUNC('month', created) AS month,
    COUNT(*) AS charge_count,
    SUM(amount) / 100.0 AS gross_revenue,
    SUM(CASE WHEN refunded THEN amount_refunded ELSE 0 END) / 100.0 AS refunds,
    (SUM(valor) - SUM(CASE WHEN reembolsado THEN valor_reembolsado ELSE 0 END)) / 100.0 AS receita_líquida
FROM stripe.charges
WHERE status = 'bem-sucedido'
  AND criado >= CURRENT_DATE - INTERVAL '12 meses'
GROUP BY DATE_TRUNC('mês', criado)
ORDER BY mês DESC;
Assinaturas ativas por plano
SELECT
    p.name AS nome_do_produto,
    pr.nickname AS nome_do_plano,
    pr.interval AS intervalo_de_faturamento,
    pr.unit_amount / 100.0 AS preço,
    COUNT(s.id) AS assinantes_ativos,
    COUNT(s.id) * pr.unit_amount / 100.0 AS contribuição_mrr
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;
Análise de pagamentos com falha
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;

Compartilhe relatórios do Stripe sem compartilhar credenciais

Abra qualquer consulta Stripe no Query Builder → clique no Compartilhamento guia → insira os endereços de e-mail dos colegas de equipe → clique em CompartilharOs destinatários recebem a consulta apenas no complemento do Google Sheets. Eles a executam sob demanda para obter dados em tempo real — sua chave da API do Stripe nunca é exposta e eles nunca veem o código SQL.

Perguntas frequentes

Posso usar minha chave API do modo de teste do Stripe?
Sim. O Query Streams funciona tanto com dados ao vivo (sk_live_) e teste (sk_test_Chaves de API. O modo de teste é ideal para avaliar a integração antes de conectar sua conta de produção.
Qual é a diferença entre cobranças e intenções de pagamento?
As cobranças representam transações de pagamento individuais. As intenções de pagamento são o objeto de fluxo de pagamento moderno do Stripe que rastreia todo o ciclo de vida do pagamento. Para relatórios históricos, use as cobranças; para novas integrações, use as intenções de pagamento.
Quantos dados históricos do Stripe o Query Streams sincroniza?
Por padrão, o Query Streams sincroniza os dados mais recentes de cada tabela. Você pode ajustar o período de retrospectiva nas configurações do conector. A sincronização inicial pode levar vários minutos para contas com grande volume de transações.
Posso conectar várias contas Stripe?
Sim. Você pode adicionar várias conexões Stripe a um único agente — cada uma com uma chave API diferente. Cada conexão aparece como uma fonte de dados separada no construtor de consultas, permitindo que você consulte e compare várias contas Stripe na mesma consulta SQL.

Guias relacionados

Categoria: Conectores API

Tags: Stripe, Google Sheets, API, Dados de Pagamento, SQL, Análise de Receita, Assinaturas, Dados em Tempo Real

Metadescrição: Conecte o Stripe ao Google Sheets com SQL. Consulte clientes, faturas, assinaturas e cobranças em tempo real — sem necessidade de programação de API. Guia de configuração passo a passo.

Atualizado em 3 de junho de 2026

Desenvolvido por BetterDocs