Pixel na XPag: Facebook, Google Ads e TikTok

A integração com a XPag envia cada pagamento confirmado 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 e ID da transação. Funciona com cobranças em real (PIX), peso mexicano (SPEI e OXXO), peso colombiano (Nequi e Bre-B) e peso chileno.

O webhook da XPag não traz cookies, email, telefone, nome nem UTMs: o Track Combo só consegue ligar a venda à visita pelo ID da transação. Por isso, além da Web Tag na página onde a cobrança é gerada, o seu site precisa disparar um evento com esse ID logo depois de criar a cobrança (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 XPag com chave de API
• Integração via API da XPag (site próprio, checkout próprio, bot)
• Projeto criado no TrackCombo
• Web Tag instalada na página onde a cobrança é gerada, 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 XPag
5. Copie a URL do webhook gerada pelo TrackCombo

# 2. Configure o Webhook na XPag

A XPag não tem cadastro de webhook no painel: o webhook é informado em cada cobrança, no campo webhook_url da chamada de criação (POST https://api.xpag.global/cashin).

1. No código que gera a cobrança, preencha webhook_url com a URL copiada do TrackCombo:

{
  "currency": "BRL",
  "amount": 197.00,
  "external_id": "PEDIDO-123",
  "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, com o corpo intacto. A XPag aceita apenas uma URL por cobrança.

# 3. Envie o ID da Transação pela Tag (recomendado)

Para o TrackCombo ligar a venda à sessão do visitante (e às campanhas que trouxeram ele), dispare um evento pela tag logo depois de criar a cobrança, informando o transaction_id retornado pela XPag:

dispararEvento({
  event: 'add_payment_info',
  transaction_id: '<transaction_id retornado pela XPag>',
  value: 197.00,
  currency: 'BRL',
  user_data: { email: '<email do cliente>', phone: '<telefone do cliente>' }
});

Use o transaction_id da XPag, não o seu external_id. A função dispararEvento está explicada em Disparar Eventos Customizados via JavaScript. Sem esse passo, a venda chega às plataformas de anúncio sem nenhum dado do comprador, e a atribuição fica praticamente nula.

# 4. Teste a Integração

1. Gere e pague uma cobrança de teste (no sandbox da XPag, use a simulação de pagamento com resultado paid)
2. No TrackCombo, acesse o projeto e vá na aba Eventos
3. Verifique se o evento purchase apareceu com o valor e a moeda corretos

# Pixels que funcionam com a XPag

A XPag gera um único evento no Track Combo: o pagamento confirmado (status confirmed), tratado como compra (purchase). Cada pixel recebe a venda com o nome que a plataforma de anúncio espera.

# Facebook (Meta)

Pagamento confirmado vira Purchase na API de Conversões, com valor, moeda, ID da transação e os dados do comprador ligados pelo passo 3. Precisa do Token de Conversão cadastrado no pixel. Veja como configurar o pixel do Facebook.

# Google Ads

Pagamento confirmado 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)

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

# TikTok

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

# Pinterest

Pagamento confirmado 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

Pagamento confirmado 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)

Pagamento confirmado 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 pedido no seu sistema (external_id)
• Valor do pagamento
• Moeda (BRL, MXN, COP ou CLP)
• País (deduzido da moeda)
• Método de pagamento (PIX, SPEI, Bre-B etc.)

Apenas cobranças com pagamento confirmado geram venda. Cobranças pendentes ou expiradas, saques, disputas (MED) e pagamentos em cripto (USDT e USDC) são ignorados.

# Problemas Comuns

Como instalar o pixel do Facebook na XPag?
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 cobrança e dispare o evento com o ID da transação pela Web Tag (passo a passo acima). Cada pagamento confirmado chega no Facebook como Purchase pela API de Conversões.

A XPag 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 (passo 3), porque o webhook da XPag não traz cookies. Também é preciso ter o Conversion Label de compra cadastrado no pixel do Google Ads.

Por que pagamentos em USDT ou USDC não aparecem?
As plataformas de anúncio só aceitam moedas oficiais (real, dólar, peso etc.). Pagamentos em cripto não são enviados.

Vendas não aparecem no TrackCombo?

• Confirme que o webhook_url da cobrança 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