🔌 Integrações

Pixel no Stripe: Facebook, Google Ads e TikTok

Envie as vendas do Stripe pro Facebook, Google Ads, GA4, TikTok, Pinterest, Taboola e OpenAI pela API de Conversões, server-side, a cada checkout concluído.

A integração com o Stripe envia cada checkout concluído (checkout.session.completed) pros pixels do Facebook (Meta), Google Ads, GA4, TikTok, Pinterest, Taboola e OpenAI, pela API de Conversões de cada plataforma (server-side). A venda vai como evento de compra com valor, moeda, ID da sessão de checkout e os dados que o comprador preencheu no Stripe (nome, email, telefone e endereço).

O webhook do Stripe não traz os cookies do navegador nem as UTMs da visita. Por isso o Track Combo cruza a venda com a visita registrada pela Web Tag na página onde o cliente clica pra pagar (a página que leva ao Payment Link ou ao Checkout do Stripe) e completa o evento com fbp, fbc, gclid, ttclid e UTMs antes de enviar pros pixels.

Requisitos

  • Conta ativa no Stripe com acesso à API
  • Projeto criado no TrackCombo
  • Web Tag instalada na página onde o cliente inicia o pagamento, pra venda ser ligada ao clique no anúncio
  • Pelo menos um pixel cadastrado no projeto com a API de Conversões ativa

Passo a Passo

1. Adicione a Integração no TrackCombo

  1. Abra seu projeto 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 projeto e vá na aba Eventos
  3. Verifique se o evento de pagamento apareceu
  4. Confirme que os dados do comprador foram recebidos corretamente

Pixels que funcionam com o Stripe

O Stripe gera um único evento no Track Combo: o checkout concluído (checkout.session.completed), tratado como compra (purchase). Cada pixel recebe esse evento com o nome que a plataforma de anúncio espera.

Facebook (Meta)

Checkout concluído no Stripe vira Purchase na API de Conversões, com valor, moeda, ID da transação e dados do comprador. Precisa do Token de Conversão cadastrado no pixel. Veja como configurar o pixel do Facebook.

Checkout concluído vira a conversão de compra do Google Ads. O envio usa o Conversion Label que você cadastra no pixel pro evento purchase; sem label, a venda não é enviada. Veja como configurar o pixel do Google Ads.

GA4 (Google Analytics)

Checkout concluído vira purchase no GA4 pelo Measurement Protocol, com valor, moeda, ID da transação e as UTMs da visita registrada pela Web Tag. O Stripe não manda a lista de itens no webhook. Precisa do API Secret no pixel. Veja como configurar o GA4.

TikTok

Checkout concluído vira CompletePayment na Events API do TikTok. Precisa do token de acesso no pixel. Veja como configurar o pixel do TikTok.

Pinterest

Checkout concluído vira checkout, o evento de compra da API de Conversões do Pinterest. Precisa do token no pixel. Veja como configurar o pixel do Pinterest.

Taboola

Checkout concluído vira make_purchase. Só vão pro Taboola as vendas de quem chegou por um anúncio do Taboola (com o clique tbclid registrado pela Web Tag). Veja como configurar o pixel do Taboola.

OpenAI (anúncios no ChatGPT)

Checkout concluído vira order_created na Conversions API da OpenAI. Veja como configurar o pixel da OpenAI.

Dados Traqueados

A integração envia automaticamente:

  • ID da sessão de checkout (usado como ID da transação)
  • Valor total da compra (o Stripe manda em centavos e o TrackCombo converte)
  • Moeda (BRL, USD, etc.)
  • Nome, email e telefone do comprador (quando preenchidos no checkout)
  • País, estado, cidade, CEP e endereço (quando coletados no checkout)
  • Client Reference ID (client_reference_id), recebido como sck

Configurando Parâmetros de Traqueamento

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

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, que chega no TrackCombo como sck
  • utm_source, utm_medium, utm_campaign, utm_content, utm_term: aparecem nos relatórios do Stripe; no TrackCombo, as UTMs da venda vêm da visita registrada pela Web Tag
  • 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 traqueamento 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) e o TrackCombo converte automaticamente

Problemas Comuns

Como instalar o pixel do Facebook no Stripe?
O Stripe não tem campo de pixel no checkout. Cadastre o pixel do Facebook com o Token de Conversão no seu projeto do Track Combo e conecte o Stripe pelo webhook (passo a passo acima). Cada checkout concluído chega no Facebook como Purchase pela API de Conversões, sem depender do navegador do comprador.

O Stripe envia conversões pro Google Ads?
Sim. Com a integração ativa e o pixel do Google Ads cadastrado com o Conversion Label de compra, cada checkout concluído no Stripe é enviado como conversão. O gclid vem da visita registrada pela Web Tag na página que leva ao checkout.

Pagamento por boleto no Stripe vira venda antes de ser pago?
Pode virar. A integração usa o checkout.session.completed, e em métodos de pagamento com confirmação posterior (como boleto) o Stripe dispara esse evento quando o cliente finaliza o checkout, antes da compensação. Com cartão, o checkout só conclui com o pagamento aprovado.

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
stripeintegraçãowebhookpagamentopixelapi de conversõescheckout.session.completedpayment link