Idempotência é a propriedade de uma operação que, repetida várias vezes com os mesmos parâmetros, produz exatamente o mesmo resultado — sem duplicar registros.
Na Vanilla Pag, o campo external_id garante idempotência: dois POSTs /v1/payment-transaction/create com o mesmo external_id sempre retornam a mesma cobrança (não duplica). Isso protege contra retries de rede, double-click no checkout e bugs de re-envio.
Aplique a mesma técnica no seu webhook handler: use o id da transação como chave única antes de processar.