Skip to main content
Endpoint que a xTracky expõe pra cada plataforma de pagamento integrada. Você não chama diretamente — quem chama é o gateway, com o payload dele. A xTracky normaliza automaticamente pra o formato canônico interno.
POST https://api.xtracky.com/api/integrations/{plataforma}

​
Como usar

1

Descubra o slug

Ver lista completa de plataformas.
2

Configure o webhook no painel do gateway

Cole a URL https://api.xtracky.com/api/integrations/{slug}.
3

Pronto

A xTracky recebe, normaliza e dispara conversão pras redes.
Ver o passo a passo detalhado.

​
Payload

O payload é o formato nativo do gateway. A xTracky mantém um transformer por plataforma que traduz cada campo (currency, status, amount, UTM, lead) pro formato canônico interno. Ou seja: você não precisa se preocupar com o formato. Se a plataforma está na lista, a xTracky entende.

​
Exemplos por gateway

O gateway Vega envia payload com transaction_id, status, amount_cents, client_utm_source. Traduzido automaticamente.

​
Resposta

Todos os webhooks respondem sempre 200 OK (mesmo em caso de dedup) pra evitar que o gateway retente desnecessariamente. Erros de payload são logados no painel em Dashboard → Webhooks → Falhas.
Se o gateway está enviando webhook mas nada aparece no painel, cheque em Dashboard → Webhooks → Falhas. Provavelmente há um erro de normalização (campo esperado ausente, status desconhecido, etc.). Ver Configurar webhook para debug.

​
Adicionando uma nova plataforma

Se você é o dono ou parceiro da plataforma e quer se integrar oficialmente à xTracky:
1

Envie a documentação

Mande pro suporte@xtracky.com:
  • Doc de webhook (formato do payload, headers, assinatura HMAC)
  • Exemplo real de payload pra cada tipo de evento
  • Como o cliente configura o webhook no seu painel
2

Aguarde o transformer

Nosso time cria o transformer DB-driven em 3-5 dias úteis. Você recebe o slug (/api/integrations/{seu-nome}).
3

Divulgue

A partir daí, seus clientes podem apontar webhook pra xTracky sem código.