Visão geral dos webhooks

Página em construção

Este é um resumo. O conteúdo completo entra nas próximas versões da documentação; o contrato de cada rota já está na Referência da API.

A Kodano envia um POST para a sua URL a cada evento assinado: pagamentos, estornos, chargebacks, saques, liquidações e desativação de endpoint.
Cada entrega é assinada em X-Kodano-Signature (HMAC-SHA256). Verifique sempre antes de processar.
Responda 2xx em até 10 segundos. Falhas são retentadas por 24 horas.
Entregas podem chegar duplicadas ou fora de ordem: deduplique pelo id do evento.

{
  "id": "evt_NAReVGpteI9IpjpimY69TtHrjIyl5ykV",
  "type": "payment.succeeded",
  "apiVersion": "2026-10-01",
  "createdAt": "2026-10-16T13:02:11Z",
  "environment": "sandbox",
  "merchantId": "mrc_e3cc4727054da558273162251e310d29",
  "data": { "object": { "id": "pay_Nj7ZJCZ9jM7SGGmnjGl9UAXLW7BpYwCL", "status": "SUCCEEDED", "...": "..." } }
}