Webhooks API

Objetivo

Ingerir eventos Stripe com validação criptográfica, deduplicação por evento e capacidade de replay controlado para recuperação operacional.

Endpoints principais

Modelo de processamento

1. 11) Receber evento

   Validar assinatura e formato mínimo do payload.

2. 22) Deduplicar

   Usar event.id como chave lógica de idempotência.

3. 33) Enfileirar processamento

   Executar pipeline assíncrono com reprocessamento seguro.

4. 44) Confirmar estado

   Atualizar estado funcional e métricas de entrega.

Exemplo de evento recebido

{
  "id": "evt_123",
  "type": "invoice.paid",
  "created": 1710492000,
  "data": {
    "object": {
      "id": "in_123",
      "customer": "cus_123"
    }
  }
}

Política de retries e replay

• Retries automáticos devem manter contexto original do evento.
• Replay manual apenas com escopo temporal e organizacional explícito.
• Nunca executar replay massivo sem priorização por impacto e sem janela de controlo.

Erros e sinais operacionais