Visão geral de webhooks - Korbit

Webhooks são a forma primária de saber que algo aconteceu na sua conta: pagamento confirmado, refund solicitado, saque atualizado, disputa aberta. A API continua disponível para consulta — mas você não deve depender de polling.

Como funciona

Você expõe um endpoint HTTPS público e registra uma assinatura de webhook informando a URL e os tipos de evento de interesse.
A Korbit entrega cada evento com cabeçalhos de assinatura (Svix) que permitem verificar autenticidade e integridade — veja Verificação de assinatura.
Seu endpoint responde 2xx rápido (< 5 s). Falhas entram na agenda de retries.

Boas práticas essenciais

Ambientes

Sandbox e produção têm assinaturas e eventos independentes. Desenvolva com assinaturas test (e simulação), depois registre as mesmas URLs no ambiente live durante o go-live.

Gestão

Assinaturas são gerenciadas por API (criar, listar, desabilitar) — veja Gestão de assinaturas.