Glossário de pagamentos
O que é idempotência
Propriedade de uma operação que pode ser repetida sem mudar o resultado além da primeira vez.
Em pagamentos, a rede falha: o sistema envia o pedido de cobrança, a resposta não volta e não dá para saber se a cobrança foi criada. Sem idempotência, tentar de novo pode gerar duas cobranças.
Com uma chave de idempotência, o sistema manda um identificador único junto com o pedido. Se o mesmo pedido chegar de novo com a mesma chave, a API devolve a resposta original em vez de criar outra cobrança.
Na McpfPay
Todas as criações na API da McpfPay aceitam o cabeçalho Idempotency-Key. Repetir o pedido com a mesma chave devolve a resposta original.