---
title: "Conector Stripe"
description: "Conecte o Stripe à Tajo com uma chave de API restrita para sincronizar em modo somente leitura clientes, cobranças, assinaturas e faturas nos fluxos de engajamento e migração."
url: https://tajo.io/pt/docs/connectors/ecommerce/stripe/
markdown: https://tajo.io/pt/docs/connectors/ecommerce/stripe.md
lang: pt-BR
robots: noindex
---

Solicite acesso antecipado

Indique o seu nome e endereço de e-mail profissional. Enviaremos um link para confirmar o seu pedido de acesso ao Tajo.

# Conector Stripe

Status do conector: Ativo Verificado. O Tajo executa este conector hoje.

| Campo de origem | Campo de destino | Valor de exemplo |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Conecte sua conta Stripe à Tajo para sincronizar em modo somente leitura os dados de pagamento (clientes, cobranças, assinaturas e faturas) e usá-los na resolução de contatos, na segmentação e em automações movidas por receita (via Brevo e outros provedores de engajamento).

## Visão geral

| Propriedade | Valor |
| --- | --- |
| Autenticação | Chave secreta do Stripe (`sk_live_...` / `sk_test_...`) ou chave restrita |
| Acesso | Somente leitura. A Tajo nunca escreve na sua conta Stripe |
| API base | `https://api.stripe.com/v1` |
| Direção da sincronização | Stripe → Tajo |
| Webhooks em tempo real | Ainda não. Hoje a sincronização é por polling |

## Configuração

1. No Stripe Dashboard, abra **Developers → API keys**.
2. Crie uma **chave restrita** com permissão de leitura em **Customers**, **Charges**, **Subscriptions** e **Invoices**, o que já é suficiente. Uma chave restrita é fortemente preferível à chave secreta completa: a Tajo apenas lê, então conceda apenas leitura.
3. Cole a chave na conexão Stripe dentro da Tajo.

A conexão é validada com uma requisição somente leitura antes de qualquer sincronização começar. Gire ou revogue a chave no Stripe a qualquer momento.

## O que é sincronizado

| Dados | O que a Tajo faz com eles |
| --- | --- |
| **Clientes** | Resolvidos em contatos (e-mail, nome, telefone, endereço) para identidade e segmentação. O consentimento nunca é inferido da existência de um registro de cliente. |
| **Cobranças** | Eventos de receita para automações de ciclo de vida baseadas em compra e segmentação por LTV |
| **Assinaturas** | Status do ciclo de vida (active, past\_due, canceled…) para cobrança de inadimplência, recuperação e retenção |
| **Faturas** | Status de pagamento para mensagens ligadas a faturamento |

A paginação usa o modelo de cursor do Stripe (`starting_after`), então contas grandes sincronizam por completo e de forma retomável.

## Limitações atuais

Ditas com todas as letras para que você possa se planejar:

- **Ainda não há webhooks em tempo real.** As mudanças chegam no horário da sincronização, não no momento em que um pagamento é aprovado. A ingestão por webhook está no roadmap.
- **Somente leitura.** A Tajo não cria nem modifica clientes, pagamentos ou assinaturas no Stripe.
- **Não há Stripe App.** Não existe hoje nenhum app da Tajo no Stripe App Marketplace; a conexão é configurada na Tajo, não no Stripe Dashboard.

## Solução de problemas

| Sintoma | Causa e correção |
| --- | --- |
| 401 vindo do Stripe | A chave foi revogada ou girada. Cole a chave atual na conexão |
| Os clientes sincronizam, mas as cobranças não | Falta permissão de leitura em Charges na chave restrita |
| O contato não tem e-mail | Clientes do Stripe sem e-mail são sincronizados como registros de receita anônimos; eles entram no grafo de contatos se o e-mail for adicionado depois |

## Próximos passos

- [Sincronização de clientes](https://tajo.io/pt/docs/skills/data-sync/customer-sync/): como mapear os clientes do Stripe no seu sistema de registro
- Crie automações de cobrança de inadimplência e de recuperação na Tajo com base nas mudanças de status das assinaturas