Webhooks
Seu sistema avisado em tempo real, com logs e reenvio automático.
Webhook é o caminho inverso da API: em vez de perguntar se algo mudou, seu sistema é avisado no momento em que muda.
Criando um webhook
Em Webhooks > Criar:
| Campo | Obrigatório | O que preencher |
|---|---|---|
| URL de destino | Sim | Endereço HTTPS do seu sistema que aceita POST |
| Eventos | Sim | Quais acontecimentos disparam o envio |
| Produtos | Não | Todos, ou uma seleção específica |
Eventos disponíveis
- Pedido criado / aguardando pagamento
- Pagamento aprovado
- Pagamento recusado
- Pedido expirado
- Reembolso
- Chargeback
- Assinatura criada, renovada e cancelada
- Carrinho abandonado
Como o seu endpoint deve se comportar
- Responda 200 rápido. Receba, guarde, responda; processe depois em segundo plano. Resposta lenta ou erro conta como falha.
- Seja idempotente. Em falha a Nasten reenvia com intervalos crescentes, então o mesmo evento pode chegar duas vezes. Use o ID da transação: se já processou aquele ID, ignore.
- Valide o formato antes de confiar. Durante o desenvolvimento, aponte para um inspecionador de webhooks e veja o payload real.
Logs de entrega
Em Webhooks > Logs ficam todas as tentativas: quando saiu, o corpo enviado, o que a sua URL respondeu e os reenvios. Quando "não chegou nada", a resposta está aqui, e quase sempre é a URL respondendo erro.