Skip to main content
A API da xTracky é REST + JSON. Existem dois endpoints públicos principais:

POST /api/integrations/api

Envio manual de conversão — para checkouts próprios ou gateways sem integração pronta.

POST /api/integrations/{plataforma}

Webhook automático — 90+ gateways integrados sem código.

​
URL base

​
Autenticação

A xTracky autentica requisições pelo data-token (Product ID / UUID) que você inclui no payload como utm_source (indiretamente) e/ou como parte do webhook do gateway. Não existe API key global neste momento — cada produto tem seu próprio ID e a atribuição é feita implicitamente via LeadId. Se você precisa de API key headerizada pra CI/backend, isso está no roadmap; fale com suporte@xtracky.com.

​
Formato

Todas as requisições usam:
O corpo é JSON. Não há paginação nem cursor — a API é write-only nos endpoints de integração (a leitura acontece no painel).

​
Códigos de status HTTP

​
Rate limits

  • Por Product ID: 300 req/min sustentado, burst de 100 req/s
  • Por IP de origem: 1000 req/min
Se você previa disparar mais que isso (integração em massa, replay de backup), abra ticket antes.

​
Boas práticas

Reutilize orderId

Sempre o mesmo orderId pra mesma venda (do waiting_payment até o paid).

Retry com backoff

Em 5xx/429, retry com backoff (2s, 4s, 8s). A dedup evita duplicata.

Amount em centavos

R$ 99,90 → 9990. Sempre inteiro, nunca float.

Não bloqueie o cliente

Se o POST demorar, não segure a UX — dispare async.