Skip to main content
Com o script instalado, o próximo passo é reportar as vendas à xTracky. Você tem duas opções:

Webhook automático

Aponte o webhook do seu gateway pra xTracky. Sem código.

API pública

Envie via POST sempre que uma venda for confirmada.
Este guia cobre a API pública — a rota recomendada quando você mantém o próprio backend ou quando sua plataforma de pagamento ainda não está na lista de integrações prontas.

Endpoint

POST https://api.xtracky.com/api/integrations/api

Payload mínimo

Campos essenciais

string
required
Identificador único da venda no seu sistema.
integer
required
Valor da venda em centavos (ex: R$ 99,90 → 9990).
string
required
Status atual da transação. Um de: waiting_payment, paid, initiate_checkout, failed, refunded. Ver Status de Pagamento.
string
required
O LeadId gerado pelo script V2 (ex: TT-1763007625226-yn4xita3qylwh) ou o valor do parâmetro utm_source capturado da URL (V1).
Todos os campos opcionais e detalhes de resposta estão na referência do endpoint.

E depois?

Assim que a xTracky recebe o POST com status=paid, ela:
  1. Deduplica o evento (mesmo orderId + utm_source = ignorado)
  2. Identifica a plataforma de origem pelo prefixo do LeadId
  3. Dispara o evento correspondente (Purchase, Add to Cart, etc.) pra API de conversão da rede (Meta, TikTok, Kwai ou Google)
  4. Atualiza o painel em tempo real

Ver como cada status vira evento

Tabela completa de mapeamento status → evento