Por que repetir um pagamento é perigoso — e a única linha que resolve isso.

A conexão de um cliente cai no meio do checkout, então o app dele silenciosamente repete a cobrança —três vezes. Seu código ingênuo roda três vezes. O cliente é cobrado 3× por um pedido, e agora é o seu chamado às 3h da manhã. Esse bug exato já custou dinheiro real a empresas reais. Vamos torná-lo impossível.

Idempotência: mesma solicitação, mesmo efeito — não importa quantas vezes.

Uma operação é idempotente quando fazer uma vez e fazer dez vezes leva ao mesmo lugar. O truque: dê a cada requisição uma chave, lembre-se das chaves que você já tratou, e faça uma chave repetida ser uma não-operação. Tentativas repetidas tornam-se seguras.

Aqui está o quebrado charge(). Execute — ele cobra três vezes. Depois adicione a proteção para que uma chave repetida não faça nada, e execute novamente. Python real, rodando aqui mesmo.

Verde significa 3 tentativas → 1 cobrança. Você não leu sobre idempotência — você a implementou, e uma verificação confirmou. Essa é cada lição Sage: um modelo mental, um diagrama e uma prova que um cético pode executar. Sem questionário autoavaliado, sem “acho que entendi.”