POST
https://api.xtracky.com/api/integrations/apiCorpo 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
200 OK — Aceito
200 OK — Aceito
dedupped: true significa que o evento chegou mas foi ignorado por já ter sido processado.400 Bad Request
400 Bad Request
429 Too Many Requests
429 Too Many Requests
retryAfter segundos.Proteção contra duplicatas
Requisições com o mesmoorderId + 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.