Integrar com Pushin Pay

Conecte sua conta Pushin Pay ao TrackCombo para traquear vendas via PIX automaticamente via webhook.

# 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, com a Tag Web instalada no site onde o PIX é gerado

# 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á em Logs
3. Verifique se o evento purchase apareceu com o valor correto

# 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

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

Vendas aparecem, mas sem campanha/origem?

• Verifique se a Tag Web está instalada na página onde o PIX é gerado
• Confirme que o evento com transaction_id é disparado com o mesmo id que a Pushin Pay retornou