Pixel na Pushin Pay: Facebook, Google e TikTok

A integração com a Pushin Pay envia cada PIX pago 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 em reais, ID do PIX e os únicos dados do pagador que a Pushin Pay manda: nome e CPF/CNPJ.

O webhook da Pushin Pay não traz cookies, email, telefone nem UTMs, e na prática o Track Combo só consegue ligar a venda à visita pelo ID do PIX. Por isso, além da Web Tag na página onde o PIX é gerado, o seu site precisa disparar um evento com esse ID logo depois de gerar o PIX (passo 3). Com isso o Track Combo completa a venda com fbp, fbc, gclid, ttclid, UTMs, email e telefone da visita antes de enviar pros pixels.

# Requisitos

• Conta ativa na Pushin Pay
• Integração via API da Pushin Pay (site próprio, bot de Telegram, ManyChat, Typebot etc.)
• Projeto criado no TrackCombo
• Web Tag instalada na página onde o PIX é gerado, 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 Pushin Pay
5. Copie a URL do webhook gerada pelo TrackCombo

# 2. Configure o Webhook na Pushin Pay

Na Pushin Pay, o webhook é informado em cada PIX gerado, no campo webhook_url da chamada de criação do QR Code (POST https://api.pushinpay.com.br/api/pix/cashIn).

1. No código (ou na ferramenta) que gera o PIX, preencha webhook_url com a URL copiada do TrackCombo:

{
  "value": 1990,
  "webhook_url": "https://<URL do webhook do TrackCombo>"
}

2. Se você já usa o webhook_url para o seu próprio sistema, mantenha a sua URL e faça seu sistema repassar (encaminhar) o mesmo POST recebido para a URL do TrackCombo. A Pushin Pay aceita apenas uma URL por PIX.

# 3. Envie o ID do PIX pela Tag (recomendado)

O webhook da Pushin Pay traz apenas nome, CPF e valor: não traz email, telefone, cookies nem UTMs. Para o TrackCombo ligar a venda à sessão do visitante (e às campanhas que trouxeram ele), dispare um evento pela tag logo depois de gerar o PIX, informando o id retornado pela Pushin Pay como transaction_id:

dispararEvento({
  event: 'add_payment_info',
  transaction_id: '<id do PIX retornado pela Pushin Pay>',
  value: 19.90,
  currency: 'BRL',
  user_data: { email: '<email do cliente>', phone: '<telefone do cliente>' }
});

A função dispararEvento está explicada em Disparar Eventos Customizados via JavaScript. Sem esse passo, a venda chega às plataformas de anúncio, mas com atribuição limitada.

# 4. Teste a Integração

1. Gere e pague um PIX de teste (o valor mínimo é R$ 0,50)
2. No TrackCombo, acesse o projeto e vá na aba Eventos
3. Verifique se o evento purchase apareceu com o valor correto

# Pixels que funcionam com a Pushin Pay

A Pushin Pay gera um único evento no Track Combo: o PIX pago (status paid), tratado como compra (purchase). Cada pixel recebe a venda com o nome que a plataforma de anúncio espera. Sem o evento do passo 3, a venda vai só com nome e CPF do pagador, e a plataforma de anúncio tem pouco dado pra atribuir à campanha.

# Facebook (Meta)

PIX pago na Pushin Pay 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.

# Google Ads

PIX pago 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)

PIX pago vira purchase no GA4 pelo Measurement Protocol, com valor, moeda, ID da transação e as UTMs da visita ligada pelo passo 3. A Pushin Pay não manda itens. Precisa do API Secret no pixel. Veja como configurar o GA4.

# TikTok

PIX pago vira CompletePayment na Events API do TikTok. Precisa do token de acesso no pixel. Veja como configurar o pixel do TikTok.

# Pinterest

PIX pago 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

PIX pago 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), então aqui o passo 3 é obrigatório na prática. Veja como configurar o pixel do Taboola.

# OpenAI (anúncios no ChatGPT)

PIX pago vira order_created na Conversions API da OpenAI. Veja como configurar o pixel da OpenAI.

# Dados Traqueados

A integração envia automaticamente:

• ID da transação (id do PIX)
• Valor do pagamento (convertido de centavos para reais)
• Nome do pagador
• CPF/CNPJ do pagador (criptografado)
• Método de pagamento (PIX)

Apenas PIX com status pago geram venda. PIX criados, expirados ou cancelados são ignorados.

# Problemas Comuns

Como instalar o pixel do Facebook na Pushin Pay?
Cadastre o pixel do Facebook com o Token de Conversão no seu projeto do Track Combo, coloque a URL do Track Combo no webhook_url de cada PIX e dispare o evento com o ID do PIX pela Web Tag (passo a passo acima). Cada PIX pago chega no Facebook como Purchase pela API de Conversões.

A Pushin Pay envia conversões pro Google Ads?
Sim, desde que a venda seja ligada à visita. O gclid só chega na venda quando o seu site dispara o evento com o transaction_id do PIX (passo 3), porque o webhook da Pushin Pay não traz cookies. Também é preciso ter o Conversion Label de compra cadastrado no pixel do Google Ads.

As UTMs enviadas na criação do PIX chegam no Track Combo?
Não. O campo utms da criação do PIX serve só pros relatórios do painel da Pushin Pay e não volta no webhook. No Track Combo, as UTMs da venda vêm da visita registrada pela Web Tag, ligada pelo evento do passo 3.

Vendas não aparecem no TrackCombo?

• Confirme que o webhook_url do PIX aponta para a URL do TrackCombo (ou que seu sistema está repassando o webhook)
• Confira se a URL foi copiada completa
• Aguarde até 5 minutos para processamento