Integrar com Stripe

Conecte sua conta Stripe ao TrackCombo para rastrear pagamentos e conversões automaticamente via webhook.

# Requisitos

• Conta ativa no Stripe com acesso à API
• Container criado no TrackCombo

# Passo a Passo

# 1. Adicione a Integração no TrackCombo

1. Abra seu container no TrackCombo
2. Vá em Integrações
3. Clique em + Nova Integração
4. Selecione Stripe
5. Copie a URL do webhook gerada pelo TrackCombo

# 2. Configure o Webhook no Stripe

1. Acesse o Dashboard do Stripe
2. Vá em Developers > Webhooks (ou acesse diretamente stripe.com/webhooks)
3. Clique em Add endpoint
4. Cole a URL copiada do TrackCombo no campo Endpoint URL
5. Em Events to send, selecione:
   • checkout.session.completed — Checkout finalizado com sucesso
6. Clique em Add endpoint

# 3. Teste a Integração

1. Faça uma compra de teste usando o Stripe (modo teste ou produção)
2. No TrackCombo, acesse o container e vá em Logs
3. Verifique se o evento de pagamento apareceu
4. Confirme que os dados do comprador foram recebidos corretamente

# Dados Rastreados

A integração envia automaticamente:

• ID da sessão de checkout
• Email do comprador
• Nome do comprador
• País e endereço (quando disponível)
• Valor total da compra
• Moeda (BRL, USD, etc.)
• Client Reference ID (útil para rastreamento personalizado)
• Parâmetros UTM (quando usados no link de checkout)

# Configurando Parâmetros de Rastreamento

O Stripe suporta parâmetros na URL do Payment Link para melhor rastreamento:

https://buy.stripe.com/seu-link?client_reference_id=ID_UNICO&utm_source=facebook&utm_medium=cpc&utm_campaign=campanha1

Parâmetros disponíveis:

• client_reference_id — ID de referência personalizado
• utm_source, utm_medium, utm_campaign, utm_content, utm_term
• prefilled_email — Preenche o email do comprador automaticamente

# Dicas Importantes

• Use sempre o evento checkout.session.completed — é o mais confiável para conversões
• Configure client_reference_id nos links de checkout para rastreamento avançado
• O Stripe diferencia ambientes de teste e produção — configure o webhook no ambiente correto
• Valores são enviados em centavos (ex: $50.00 = 5000) — o TrackCombo converte automaticamente

# Problemas Comuns

Pagamentos não aparecem no TrackCombo?

• Verifique se a URL do webhook está correta no Stripe
• Confirme que o evento checkout.session.completed está selecionado
• No Stripe, vá em Developers > Webhooks e verifique se há erros de entrega

Webhook retorna erro?

• Verifique se o endpoint está acessível (status 200)
• No Stripe, clique no webhook e veja os logs de tentativas
• Confirme que não há firewall bloqueando as requisições do Stripe