Menu
Documentation
Documentation /Visao geral de Webhooks
API reference Producao Sandbox mTLS + JWT

Visao geral de Webhooks

Entrega de eventos e confirmacao de processamento

Mesmo contrato

Sandbox e producao seguem a mesma referencia funcional para integracao.

Credencial separada

Cada ambiente exige token e certificado emitidos especificamente para ele.

Leitura operacional

Consulte autenticacao, seguranca e fluxos de accounts sem trocar de referencia.

Visao geral de Webhooks

Webhooks sao usados para notificar seu sistema sobre eventos relevantes de negocio.

Fluxo recomendado

  1. Registrar endpoint HTTPS da fintech.
  2. Validar autenticidade da notificacao.
  3. Processar de forma idempotente por event_id.
  4. Responder rapidamente com HTTP 2xx.
  5. Executar processamento pesado de forma assincrona.

Recomendacoes tecnicas

  • Timeout curto e retries controlados.
  • Log estruturado de entrega e ack.
  • Dead-letter para eventos falhos.
  • Monitoramento de taxa de erro por webhook.