Documentação de Webhooks TukanoPay
Bem-vindo à documentação de integração dos webhooks do TukanoPay. Aqui você encontra todos os eventos disponíveis, exemplos de payload e como validar as requisições.
O que são webhooks?
Webhooks permitem que sua aplicação receba notificações em tempo real quando algo acontece na sua conta TukanoPay — por exemplo, quando uma compra é aprovada, um PIX é gerado ou uma assinatura é renovada.
Como usar esta documentação
- Visão geral — Entenda como funcionam os webhooks e o formato das requisições.
- Autenticação — Como validar que a requisição veio do TukanoPay usando o secret e a assinatura.
- Eventos — Para cada evento, você encontra:
- Quando ele é disparado
- Exemplo completo do payload (JSON)
- Descrição dos campos
Configurando webhooks no painel
No painel TukanoPay, acesse Apps → Webhooks. Cadastre a URL do seu servidor, escolha os eventos que deseja receber e, se quiser, defina um secret para validar as requisições.
Resposta esperada
Seu endpoint deve responder com HTTP 200 em até 10 segundos. Caso contrário, a entrega pode ser considerada falha (o TukanoPay pode tentar reenviar em cenários futuros).