Skip to main content
Cada plataforma tem um painel diferente pra configurar webhook, mas o processo é sempre o mesmo:
1

Descubra o slug da sua plataforma

O slug é o nome da plataforma em minúsculas. Alguns exemplos:A lista completa está em Plataformas integradas.
2

Acesse o painel do seu gateway

Procure por seções como Webhooks, Integrações, Postbacks, Notificações ou Callbacks. O nome varia.
3

Cadastre o webhook

  • URL de destino: https://api.xtracky.com/api/integrations/{seu-slug}
  • Método: POST
  • Content-Type: application/json
  • Eventos: todos os relacionados a pagamento (payment.created, payment.paid, payment.refunded, etc.). Se o gateway não deixar filtrar, envie todos — a xTracky ignora o que não interessa.
4

Salve e teste

A maioria dos gateways permite disparar um webhook de teste. Se não, faça uma venda real de valor mínimo (R$ 1,00 se possível) e acompanhe no painel xTracky.A venda deve aparecer em Dashboard → Vendas em tempo real em alguns segundos.

​
O que fazer se a venda não aparecer

Bateu o nome certo? Sem hífen? Sem maiúscula? Alguns gateways tem “slug” que não é óbvio pelo nome comercial. Consulte a lista completa.
Nos logs do gateway, confirme que o webhook foi disparado e recebeu HTTP 2xx da xTracky. Se recebeu 4xx/5xx, veja o corpo da resposta pra pista.
Alguns gateways exigem que você cadastre a URL no formato específico deles pra validar assinatura. A xTracky aceita as assinaturas padrão de cada gateway automaticamente — só garanta que você usou a URL exata da lista.
O gateway precisa passar o utm_source (ou equivalente) pra xTracky. Confirme que o script está capturando UTMs no checkout e que o gateway está persistindo esse valor no pedido.
Abra ticket em suporte@xtracky.com com:
  • Nome do gateway
  • Screenshot da config do webhook
  • Um orderId de teste que não subiu
  • Print do log de webhook do gateway (com timestamp)

​
Testando localmente

Se você quer testar seu funil sem envolver o gateway, use a API pública: