Idempotência
Como o Ecom evita efeitos duplicados em webhooks e capturas de pagamento.
3 min de leituraAtualizado em 14 de agosto de 2026
Operações de pagamento podem chegar mais de uma vez (o gateway reenvia webhooks até receber 2xx). O processamento no Ecom é idempotente: o mesmo evento aplicado duas vezes produz o mesmo estado — sem baixar estoque nem creditar cashback em dobro.
Webhooks inbound
POST /webhooks/{gateway} deduplica pelo id do evento do provedor. Reprocessar um evento já aplicado retorna 200 sem repetir os efeitos colaterais.
Webhooks outbound
- Cada entrega inclui um id de evento estável — use-o como chave de deduplicação no seu endpoint.
- Responda 2xx rápido; falhas são reenviadas com backoff (a mesma entrega pode repetir).
- Valide a assinatura (secret da inscrição) antes de confiar no payload.
Guarde os ids de evento já processados por uma janela de tempo e ignore repetições — é a forma mais simples de tornar o seu consumidor idempotente.