Skip to main content
Endpoint universal pra reportar qualquer evento de conversão à xTracky. Use quando seu gateway não está na lista de integrações prontas ou quando você quer controle total do payload.
POST https://api.xtracky.com/api/integrations/api

Corpo da requisição

Parâmetros

Obrigatórios

string
required
Identificador único da venda no seu sistema. Reutilize o mesmo ao longo do ciclo (waiting_payment → paid → refunded).
integer
required
Valor da venda em centavos (R$ 99,90 → 9990). Sempre inteiro.
enum
required
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 utm_source capturado da URL (V1).

Opcionais

string
default:"CUSTOM"
Nome da plataforma de origem. Detectado automaticamente pelo prefixo do utm_source no V2.
string
Nome completo do comprador. Melhora o matching na API de conversão da Meta.
string
E-mail do comprador. Hash SHA-256 é aplicado automaticamente antes de enviar pra Meta/TikTok/etc.
string
Telefone no formato E.164 (+5511999999999). Também é hasheado.
string
CPF ou CNPJ. Usado apenas pra dedup local, nunca enviado às redes de anúncio.
string
default:"BRL"
Moeda ISO-4217. Padrão BRL. Suporta USD, EUR, MXN, etc.

Respostas

dedupped: true significa que o evento chegou mas foi ignorado por já ter sido processado.
Retry após retryAfter segundos.

Proteção contra duplicatas

Requisições com o mesmo orderId + utm_source são processadas apenas uma vez. Você pode reenviar à vontade — retries, replays de fila, testes — que a xTracky garante que o evento na plataforma de anúncio dispara apenas uma vez. Ver Deduplicação.