xTracky Docs — Rastreamento de conversões e tracking multi-plataforma

O campo status que você envia à xTracky determina qual evento é reportado pra cada plataforma de anúncio.

Tabela de mapeamento

Status	Descrição	Evento disparado
`waiting_payment`	Venda gerada, aguardando pagamento (PIX, boleto)	`Add to Cart`
`paid`	Pagamento confirmado	`Purchase`
`initiate_checkout`	Usuário iniciou o checkout (preencheu dados)	`InitiateCheckout`
`failed`	Pagamento falhou ou foi recusado	—
`refunded`	Venda reembolsada	—

Nomenclatura por plataforma — Os eventos são traduzidos conforme a rede:

Pra maximizar sinal enviado às plataformas:

No clique de 'Comprar'

Dispare status=initiate_checkout (ou use o botão automático data-xtracky-checkout).

Quando o gateway gera a cobrança

Envie status=waiting_payment com o orderId e o valor. Isso dispara AddToCart na plataforma.

Quando o pagamento é confirmado

Envie status=paid com o mesmo orderId do passo anterior. A xTracky reconhece que é a mesma venda e dispara Purchase.

Se o pagamento falhar ou for reembolsado

Envie status=failed ou status=refunded com o mesmo orderId. Isso é registrado no painel (mas não gera evento pra rede).

Sempre reutilize o mesmo orderId ao longo do ciclo de vida da venda. É por ele que a xTracky evita disparar Purchase duplicado.

A requisição é rejeitada com HTTP 400. Os únicos valores aceitos são os cinco listados acima.