Conector Stripe
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
- No Stripe Dashboard, abra Developers → API keys.
- 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.
- 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: 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