Integrações
15 gateways suportados out-of-the-box. Cada um vem com webhook handler que valida a autenticidade do evento e normaliza pros eventos padrão da Meta.
01 Gateways suportados
Conexão nativa com os principais gateways e plataformas do Brasil. Cada integração tem o passo a passo completo dentro do app, em Integrações → Nova integração.
02 Setup do webhook
O fluxo é o mesmo pra qualquer gateway:
No painel Trakd: Integrações → Nova integração → escolha o gateway.
Trakd gera uma URL de webhook única e secreta pra aquela integração.
No painel do gateway, cole essa URL no campo de webhook e selecione os eventos.
Faça uma venda teste (a maioria dos gateways tem sandbox) e confirme em Eventos no painel Trakd.
Cada gateway tem instruções específicas (onde criar o webhook, quais eventos marcar e, quando o gateway oferece um token próprio, onde copiá-lo). Tudo isso aparece na tela de detalhe da integração, dentro do app.
03 Como protegemos o webhook
A autenticidade de cada evento é garantida em camadas, e a validação varia conforme o que o gateway oferece:
- URL secreta por integração. Toda integração recebe um endereço único com um segredo aleatório. Sem ele, o evento é descartado. Essa camada vale pra todos os gateways.
- Assinatura ou token do próprio gateway. Quando o gateway envia um mecanismo próprio de verificação (como o Hottok da Hotmart ou o Signing Secret do Stripe), o Trakd valida também esse segundo fator.
- Comparação em tempo constante. Toda checagem de segredo é feita de forma timing-safe, pra não vazar informação por tempo de resposta.
Os segredos de cada integração ficam guardados criptografados e nunca aparecem em logs. Você gerencia tudo (rotacionar segredo, reenviar teste) dentro do painel.
04 Mapeamento de eventos
Cada gateway tem nomenclatura própria pros status de pedido. Trakd normaliza pra eventos padrão da Meta:
| Status do gateway | Evento Meta |
|---|---|
| aprovado / pago | Purchase |
| reembolsado | Refund (custom) |
| chargeback / disputa | Chargeback (custom) |
| assinatura criada | Subscribe |
| assinatura cancelada | CancelSubscription (custom) |
| carrinho abandonado | AbandonedCart (custom) |
05 Retry e idempotência
Trakd processa cada webhook em at-least-once delivery via fila assíncrona. Tentativas que falham re-tentam com backoff exponencial. Eventos repetidos do mesmo pedido são deduplicados por um identificador determinístico: duplicação de webhook não duplica conversão na Meta.
Seu gateway está aqui
Conecte em minutos: cole a URL do webhook e faça uma venda teste.
Testar por 7 dias