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

Conectar o Stripe ao Google Sheets

Obtenha dados de Listrado em Planilhas Google

Importe dados em tempo real da sua conta Stripe para o Google Sheets e atualize-os quando quiser. Sem uploads de CSV, sem Apps Script, sem copiar e colar. Leva cerca de dez minutos na primeira vez, e o plano gratuito cobre esse custo.

Cerca de 10 minutos Não é necessário programar As credenciais permanecem com você. Qualquer navegador, qualquer dispositivo

O resultado final será o que você obterá.

Uma planilha do Google que exibe os resultados em tempo real de uma consulta SQL na sua conta Stripe, com um botão que busca as linhas mais recentes sempre que os dados forem alterados. Assim:

Vendas Salvo no Drive

ArquivoEditarVisualizarInserirFormatarDadosFerramentasExtensõesAjuda

	A	B	C	D	E
1	ID do cliente	primeiro nome	sobrenome	país	total
2	1042	Maria	Álvarez	EUA	1,284.50
3	1043	Daniel	Okafor	EUA	612.00
4	1047	Priya	Nair	EUA	2,090.75
5	1051	Thomas	Berg	EUA	338.20
6	1056	Lúcia	Ferreira	EUA	1,455.00
7	1060	Kenji	Sato	EUA	874.10
8

+ clientes Folha1 Ao vivo do Stripe

O Stripe armazena seus dados por trás de sua API. Para importá-los para o Google Sheets, geralmente é necessário exportar um arquivo CSV do painel do Stripe sempre que precisar de novos números. O Query Streams elimina essa necessidade: um pequeno programa auxiliar, chamado Agente, executa a consulta no local onde seus dados estão armazenados, e um complemento do Google Sheets solicita as linhas desejadas. Somente os resultados são transmitidos por meio de uma conexão criptografada, e o Google Sheets pode ser acessado de qualquer lugar: em qualquer navegador e em qualquer dispositivo.

O que você vai precisar

Uma conta do Query Streams

O plano gratuito é suficiente para este guia. Cadastre-se em my.querystreams.com.

O Agente em qualquer computador sempre ligado

Um pequeno programa que roda em segundo plano e faz chamadas ao Stripe quando o Google Sheets solicita. Ele só precisa de acesso à internet.

Seu login do Stripe

Você fará login no Stripe uma única vez e concederá acesso de leitura. Nenhuma senha é digitada nos Fluxos de Consulta.

Conecte-o em cinco etapas

1. Crie sua conta

   Vá para my.querystreams.com e inscreva-se. Escolha o Gratuito plano. É um plano real, não uma versão de teste, e inclui a conexão da sua conta Stripe e a execução de consultas a partir do Google Sheets.

2. Instale o Agente em qualquer computador que esteja sempre ligado.

   Faça login e abra DownloadInstale o Agente em qualquer computador ou servidor que esteja sempre ligado e com acesso à internet. Leva apenas um minuto e, a partir daí, ele inicia automaticamente.

   Por que um programa pequeno em vez de um driver? O Agente é um único instalador para Windows, Mac ou Linux (cerca de 85 MB no Windows, um pouco mais de 100 MB no Mac e Linux) que funciona silenciosamente em segundo plano. Ele estabelece uma única conexão de saída criptografada com o Query Streams, da mesma forma que um navegador, portanto, você não precisa abrir nenhuma porta de firewall nem configurar uma VPN. Suas chaves permanecem nessa máquina e as linhas são enviadas para onde você estiver, pela internet, se necessário. A única coisa do seu lado é o complemento.

   A página de download mostra Sua chave de acessoCole o código no Agente quando solicitado e aguarde até que o crachá exiba a mensagem. Conectado a fluxos de consultaEssa é a única coisa que você faz no próprio Agente.

   Guias completos, se você quiser: Janelas, Mac, Linux.

3. Aponte para sua conta Stripe.

   De volta ao seu navegador, abra Agentes de dados (sob Dados (no menu superior). Seu agente está listado lá. Clique Adicionar conector e escolha ListradoPrecisa das suas credenciais do Stripe primeiro? Abra o guia passo a passo e preencha o formulário:

   Crie suas credenciais do Stripe (cerca de 8 minutos)

   Em seguida, abra o Stripe em outra aba. O Query Streams armazena o que você cria aqui para que seu agente possa usar, e lê apenas do Stripe.

   Quem pode fazer isso?

   Proprietário da conta, Superadministrador, Administrador ou Desenvolvedor (as funções do Stripe que podem criar chaves de API)

   Recomendado

   Chave de API restrita com permissões somente de leitura (rk_live_… para dados em produção, rk_test_… para um ambiente de teste).

   Antes de começar

   • É necessário ter um login no Stripe com a função de Proprietário da conta, Superadministrador, Administrador ou Desenvolvedor. Outras funções (Analista, Somente visualização, Suporte etc.) não podem criar chaves de API.
   • Acesso à caixa de entrada de e-mail ou ao telefone para o qual o Stripe envia os códigos de verificação. O Stripe solicita um código antes de criar a chave.
   • O assistente de fluxos de consulta será aberto em outra guia (Agentes de dados → Adicionar conector → Stripe) com seu agente online, para que você possa colar a chave assim que o Stripe a exibir.

   Passos

   1. Faça login e escolha dados reais ou um ambiente de teste (sandbox).

      Faça login no painel de controle do Stripe. O Stripe mantém os dados de produção e os dados de teste separados, e cada um tem sua própria chave. Para seus pagamentos reais, permaneça na sua conta comercial, não em um ambiente de teste. Para dados de teste, abra o seletor de contas do painel de controle, clique em "Ambientes de teste" e abra o ambiente de teste desejado.

      Uma chave de produção não pode ler dados do ambiente de teste (sandbox), e uma chave de ambiente de teste (sandbox) não pode ler dados de produção. Se você precisar de ambas, crie uma chave em cada ambiente e adicione cada uma como seu próprio conector do Stripe em Fluxos de Consulta.

   2. Abra a página de chaves da API.

      Abra a página de chaves de API. Dentro do Painel de Controle, você também pode clicar em Desenvolvedores (canto inferior esquerdo) e selecionar Chaves de API. A página possui duas listas: Chaves padrão (chaves públicas e chaves secretas) e Chaves restritas.

      Vai usar um ambiente de teste (sandbox)? Primeiro, abra o ambiente de teste (passo 1). Cada ambiente de teste tem sua própria página de chaves de API e suas próprias chaves.

   3. Inicie uma chave restrita.

      Na lista de chaves restritas, clique em Criar chave restrita. Em algumas contas, essa opção aparece como + Criar chave restrita.

      Não use a chave pública (pk_…). Ela não tem permissão para ler dados da conta. Uma chave secreta (sk_…) também funciona no Query Streams, mas ela pode fazer qualquer coisa na sua conta, incluindo reembolsos e pagamentos. O Stripe recomenda chaves restritas, e o Query Streams só precisa de permissão de leitura.

   4. Explique como a chave será usada.

      O Stripe perguntará como você usará a chave. Escolha "Criando sua própria integração" e clique em "Continuar".

      Não selecione "Autorizar acesso do agente à sua conta". Essa opção marca a chave para agentes de IA e adiciona as regras de aprovação do Stripe. Se você selecionou "Fornecer esta chave a outro site" por engano, marque "Personalizar permissões para esta chave" na próxima tela. Se você deixar desmarcado, o Stripe atribuirá à chave suas permissões padrão em vez da lista somente leitura da etapa 7.

   5. Comece sem permissões.

      O Stripe oferece modelos de permissão prontos ou a opção de começar do zero. Escolha começar do zero (selecione suas próprias permissões), assim todas as permissões começarão com o valor "Nenhum".

      O Stripe altera frequentemente a redação desta tela. Procure uma opção com o texto "Começar do zero" ou "Escolher o meu", e não um modelo. Se a tela não estiver presente, vá diretamente para o passo 6.

   6. Dê um nome à chave.

      No campo Nome da chave, digite um nome que você reconhecerá mais tarde, por exemplo, Fluxos de consulta (somente leitura).

   7. Defina a leitura nos 13 recursos. Sincronizações de fluxos de consulta.

      Cada linha de recurso tem três opções: Nenhuma, Ler e Gravar. Clique em Ler nessas 13 linhas e deixe todas as outras como Nenhuma. Em Núcleo: Saldo, Origens de transação de saldo, Cobranças e reembolsos, Clientes, Disputas, Eventos, Intenções de pagamento, Pagamentos, Produtos. Em Faturamento: Cupons, Faturas, Preços, Assinaturas. Para encontrar uma linha rapidamente, pressione Ctrl+F (Cmd+F no Mac) e digite a primeira palavra do nome dela.

      Nunca selecione "Gravar". O Query Streams só lê, portanto, uma chave com permissão somente de leitura não pode criar cobranças, reembolsos ou pagamentos, mesmo que haja vazamento de dados. Você precisa da permissão "Eventos" mesmo que nunca sincronize a tabela de eventos, porque o Query Streams lê a lista de eventos do Stripe para detectar alterações entre as sincronizações. Se você usar o Connect, deixe as permissões da conta conectada como "Nenhuma". Se o nome de uma linha não corresponder ao que você vê, clique em "Ler" nas linhas de cabeçalho "Todos os recursos principais" e "Todos os recursos de faturamento". A chave ainda será somente leitura, mas poderá ler mais dados do que o Query Streams utiliza.

   8. Crie a chave

      Clique em Criar chave.

   9. Insira o código de verificação

      O Stripe envia um código de verificação por e-mail ou mensagem de texto. Digite-o na caixa de diálogo. Se a caixa de diálogo não avançar automaticamente, clique em Continuar.

      Sem código? Verifique a pasta de spam ou o número de telefone no seu perfil do Stripe.

   10. Copie a chave

       O Stripe agora exibe a nova chave. Ela começa com rk_live_ (ou rk_test_ em um ambiente de teste). Clique no valor da chave para copiá-la e, em seguida, cole-a diretamente no campo "Chave Secreta do Stripe" no assistente de Fluxos de Consulta.

       No modo de produção, o Stripe exibe a chave que você criou apenas uma vez e não pode mostrá-la novamente. As chaves do ambiente de teste (sandbox) podem ser exibidas a qualquer momento. Não envie a chave por e-mail ou chat. O Query Streams a armazena para o seu agente e só a utiliza para leitura.

   11. Observe onde a tecla é usada.

       Em Adicionar uma nota, digite onde a chave é usada, por exemplo, Agente de consulta de fluxos no computador do escritório. Em seguida, clique em Concluído. A chave agora aparecerá na lista de chaves restritas.

       A notificação aparece sempre que você ou um colega revisarem suas chaves posteriormente, para que ninguém a expire por acidente.

   Permissões a conceder

   Recurso	Acesso	Usado para
   Clientes	Ler	tabela de clientes. O teste de conexão também a lê primeiro.
   Cobranças e reembolsos	Ler	Tabelas de cobranças e reembolsos. Uma única linha engloba ambas, e não há uma linha separada para reembolsos.
   Intenções de pagamento	Ler	tabela payment_intents
   Faturas	Ler	As tabelas invoices e invoice_items. Os itens da fatura não possuem uma linha própria.
   Assinaturas	Ler	tabelas de assinaturas e itens de assinatura
   Equilíbrio	Ler	Tabela balance_transactions (lista de transações de saldo do Stripe, anteriormente chamada de histórico de saldo)
   Fontes de transação de saldo	Ler	A tabela `balance_transactions` permite que cada transação seja vinculada à cobrança, reembolso ou pagamento correspondente. O Stripe afirma que isso também concede permissão de leitura para os saldos e pagamentos.
   Pagamentos	Ler	tabela de pagamentos
   Disputas	Ler	mesa de disputas
   Produtos	Ler	tabela de produtos
   Preços	Ler	tabela de preços
   Cupons	Ler	tabela de cupons
   Eventos	Ler	A tabela de eventos e o feed de alterações mantêm atualizados os dados de clientes, assinaturas, faturas, itens de fatura, cobranças, intenções de pagamento, reembolsos, disputas, pagamentos, produtos, preços e cupons entre as sincronizações.

   Colar em Fluxos de Consulta

   Chave secreta do Stripe

   A chave restrita que você copiou na etapa 10 (começa com rk_live_ ou rk_test_). Uma chave secreta (sk_live_ ou sk_test_) também funciona, mas pode fazer muito mais do que apenas ler.

   Problemas comuns

   O teste de conexão falhou com a mensagem "Chave de API inválida".

   Por que: Parte da chave foi omitida ao copiar, um espaço foi adicionado, a chave publicável (pk_…) foi colada ou alguém expirou ou rotacionou a chave no Stripe.

   Consertar: A chave deve começar com rk_ ou sk_. Cole-a novamente sem nada antes ou depois. Se você não a tiver mais (o Stripe mostra as chaves ativas apenas uma vez), crie uma nova chave restrita (passos 3 a 11) e cole essa.

   O teste de conexão indica que a conexão foi estabelecida, mas algumas tabelas permanecem vazias e a sincronização delas exibe um erro de permissão do Stripe (403). Agentes mais recentes também exibem um aviso no teste de conexão, listando as tabelas que a chave não pode ler.

   Por que: A chave está com permissão de leitura ausente na linha dessa tabela. A mensagem de erro do Stripe indica a permissão ausente; por exemplo, rak_event_read significa Eventos.

   Consertar: Na página de chaves da API do Stripe, clique no menu ⋯ ao lado da chave, escolha Editar chave, defina a linha ausente como Leitura e salve. A chave em si não muda, portanto, não há nada para colar novamente. Clique em Testar conexão novamente em Fluxos de consulta.

   A conexão está ativa, mas você só vê dados de teste ou as tabelas estão vazias mesmo que você receba pagamentos reais.

   Por que: A chave vem de um ambiente de teste (rk_test_) quando você queria dados reais, ou vice-versa.

   Consertar: Verifique como a chave é criada. Para dados reais, use o seletor de contas para sair do ambiente de teste, crie a chave novamente (passos 2 a 11), abra o conector em Agentes de Dados, clique em Editar e cole-a em Chave Secreta do Stripe. Mantenha os conectores de teste e de produção separados.

   Um conector que funcionava normalmente parou de sincronizar devido a uma chave de API inválida.

   Por que: Alguém rotacionou ou expirou a chave no Stripe. Uma chave rotacionada continua funcionando apenas até o prazo de expiração escolhido no momento da rotação, que é de no máximo 7 dias.

   Consertar: Crie uma nova chave restrita ou copie a chave de substituição da rotação. Em Fluxos de Consulta, abra o conector, clique em Editar, cole a chave em Chave Secreta do Stripe, clique em Testar conexão e, em seguida, clique em Salvar.

   Você não consegue visualizar a opção "Criar chave restrita" ou a página de chaves de API não abre.

   Por que: Sua função no Stripe não pode gerenciar chaves de API. Funções de analista, somente visualização e suporte também não podem.

   Consertar: Peça ao proprietário da sua conta Stripe, a um administrador ou a um desenvolvedor para criar a chave para você ou para alterar sua função.

   O Stripe envia um e-mail informando que bloqueou uma solicitação e as sincronizações falham mesmo que a chave esteja correta.

   Por que: Uma política de acesso na chave (endereços IP ou Avançada) não permite o endereço de internet do computador do Agente, ou bloqueia uma VPN ou proxy que o computador utiliza.

   Consertar: Na página de chaves de API, clique em ⋯ ao lado da chave, escolha Gerenciar política de acesso e selecione uma política que permita o endereço IP público do computador do Agente ou selecione Nenhuma. Em seguida, clique em Salvar.

   A chave foi exposta (enviada por e-mail, chat ou salva em um arquivo compartilhado) ou alguém que a possuía deixou sua equipe.

   Por que: Qualquer pessoa que possua a chave pode ler tudo o que suas permissões permitirem.

   Consertar: Na página de chaves de API, clique em ⋯ ao lado da chave e escolha Girar chave. Em Expiração, selecione Agora para remover a chave antiga imediatamente e, em seguida, clique em Girar chave de API. Copie a nova chave e cole-a no conector (Editar → Chave secreta do Stripe → Testar conexão → Salvar).

   Você deseja que o Query Streams pare de ler esta conta do Stripe.

   Por que: Excluir o conector não desativa a chave. Ela permanece válida no Stripe até que você a expire.

   Consertar: Na página de chaves de API, clique em ⋯ ao lado da chave, escolha Expirar chave e clique em Expirar chave novamente para confirmar. Em seguida, exclua o conector em Agentes de Dados.

   Limites do conhecimento

   • Os eventos retrocedem 30 dias. A lista de eventos do Stripe abrange apenas 30 dias, portanto, a tabela de eventos nunca contém mais do que os últimos 30 dias. O Query Streams também lê os eventos para detectar alterações entre as sincronizações; assim, se um conector for desativado por mais de quatro semanas, a próxima sincronização lerá suas tabelas novamente por completo.
   • Velocidade de requisição: O Stripe permite 100 requisições de API por segundo no modo de produção e 25 no ambiente de teste (sandbox), e a maioria dos endpoints individuais permite 25. Cada requisição retorna no máximo 100 registros, portanto, uma primeira sincronização de 1.000.000 de cobranças requer cerca de 10.000 requisições, o que leva aproximadamente 7 minutos a 25 requisições por segundo. As sincronizações no ambiente de teste são mais lentas.
   • Limite de leitura mensal: o Stripe espera que as solicitações de leitura de uma conta não ultrapassem, em média, 500 por transação em um período de 30 dias, com um mínimo de 10.000 por mês. Cada tabela habilitada faz pelo menos uma solicitação a cada sincronização; portanto, em contas novas ou com baixo volume de transações, defina intervalos de sincronização mais longos para as tabelas que não precisam de sincronização minuto a minuto.
   • Um modo por tecla: uma tecla lê apenas o modo em que foi criada (ao vivo ou em um ambiente de teste específico).
   • Conectar: a chave lê apenas os objetos da sua própria conta. Pagamentos em contas conectadas não são sincronizados.
   • Exibindo a chave novamente: o Stripe mostra uma chave ativa que você criou apenas uma vez, enquanto as chaves de teste podem ser exibidas a qualquer momento. Ao rotacionar uma chave, a antiga continua funcionando por no máximo 7 dias.

   Etapas verificadas em 8 de outubro de 2026. Fontes: 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….

   Nome da conexão

   Qualquer nome que você reconheça mais tarde, como Banco de Dados de Vendas.

   Chave secreta do Stripe

   Sua chave secreta do Stripe pode ser encontrada no painel do Stripe, em Desenvolvedores, Chaves de API; ela começa com sk_live_ ou sk_test_.

   Clique em Teste de conexãoQuando lê Conectado, clique SalvarA conexão chega ao seu agente em poucos segundos.

   Agentes de Dados Abertos

   O teste falhou? Geralmente, trata-se de uma permissão ausente ou de credenciais de uma conta Stripe incorreta. O passo a passo acima lista os problemas comuns e suas correções.

4. Adicionar fluxos de consulta ao Google Sheets

   Abra qualquer planilha do Google e acesse Extensões → Complementos → Obter complementos, procurar Fluxos de consultae clique InstalarOu instale-o diretamente de Consultar fluxos no Google Workspace MarketplaceO Google pedirá que você permita o complemento; isso é normal.

   Depois disso, estará presente em todas as Planilhas Google que você abrir: um ícone do Query Streams no painel lateral à direita, também listado em ExtensõesNão há necessidade de fazer login separadamente. O sistema reconhece a conta do Google que você já utiliza, portanto, o e-mail precisa ser o mesmo cadastrado na sua conta do Query Streams.

5. Puxe sua primeira mesa.

   Clique no ícone "Consultar Fluxos" no painel lateral à direita da planilha (ou encontre-o em "Acessar Fluxos"). Extensões). Escolher Fluxo de consulta e selecione a conexão que você acabou de fazer.

   Digite a consulta que deseja executar. Esta consulta extrai algumas colunas de uma tabela. stripe.faturas mesa:

   Exemplo · SQL

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

   Sob Folha de Destino Selecione a aba onde as linhas devem ser exibidas e clique em Executar consultaAs linhas aparecem nessa aba em um ou dois segundos. Clique em "Executar consulta" novamente sempre que os dados forem alterados e a aba será atualizada automaticamente.

   Não conhece SQL? Em vez disso, crie a consulta no portal Query Streams. Construtor de consultas Exibe suas tabelas e colunas para que você possa apontar e clicar. Nos planos Business, você também pode usar o Nova em linguagem natural ("mostre-me os clientes nos EUA") e ele gera o SQL para você. Salve a consulta e ela estará a um clique de distância no portal e na lista de Consultas Salvas do complemento, a partir do plano Personal Core.

Boas próximas jogadas

• Salvar consulta no portal, para que você possa executá-lo novamente com um clique, a partir do Google Sheets ou do Excel.
• Adicionar um filtro como um intervalo de datas, para que a mesma consulta possa responder "este mês" sem precisar editar.
• Compartilhe os resultados Com um colega. Eles veem as fileiras, não suas credenciais.

Perguntas que as pessoas fazem

Guias relacionados

• Stripe para Microsoft Excel
• HubSpot para Google Sheets
• Shopify para Google Sheets
• Google Analytics 4 para Planilhas Google
• Power Query para Google Sheets
• Todos os guias