POST para uma URL sua sempre que um pagamento muda de estado. Assim você reage na hora a um pagamento confirmado, sem ficar consultando o checkout periodicamente.
Eventos disponíveis
O corpo de cada um está em Referência de eventos.
Criar uma assinatura
Webhooks são configurados no Dashboard — não há endpoint de API para gerenciá-los.1
Abra Desenvolvedores → Webhooks
No Dashboard, vá em Desenvolvedores e abra a aba Webhooks.
2
Cadastre o endpoint
Informe um nome, a URL (precisa ser
https://) e marque os tipos de evento que quer receber.3
Guarde o signing secret
Ao criar, a MoneyDev mostra um secret
whsec_… uma única vez. Ele é a chave usada para verificar a assinatura de cada entrega e não pode ser recuperado depois — só os últimos 4 caracteres continuam visíveis no Dashboard. Se ele vazar, gere uma nova assinatura e apague a antiga.Gerenciar no Dashboard
No seu endpoint
1
Responda rápido com 2xx
Confirme o recebimento antes de processar. Faça o trabalho pesado depois, de forma assíncrona — a janela é menor que 8 s.
2
Verifique a assinatura
Rejeite qualquer requisição cuja assinatura não bata. Veja Verificar a assinatura.
3
Seja idempotente
Use o
id do evento para descartar duplicatas antes de agir.4
Reconcilie pelo checkout
Como não há retry, rode uma verificação periódica de
GET /v1/checkouts/{checkoutId} para os checkouts que você ainda espera pagar — isso cobre eventos que nunca chegaram.