Conteúdo do curso Lição 93 de 148 · A lição da mentira
A lição da mentira

Mentira 1: apenas tente o pagamento novamente

Por que isso importa Tentar novamente é a correção mais comum para uma chamada instável, e em um pagamento é a mais cara para errar: um cliente cobrado duas vezes não se importa que foi um soluço na rede.

Conselho plantado: o conselho abaixo foi escrito para esta lição e está errado de propósito. É o tipo de resposta que um assistente de IA dá com fluidez e confiança. Seu trabalho não é discutir com ele mas provar a falha com um teste.

def pay(gateway, order_id, amount, sleep):
    # Payments fail for all sorts of temporary reasons. Retry straight away,
    # up to 5 times: by the second or third try it nearly always goes through.
    for attempt in range(5):
        try:
            if gateway.charge(amount, None) == "ok":
                return "ok"
        except TimeoutError:
            pass
    return "failed"

Lê bem e vai passar em um teste manual rápido. Agora pense no que um timeout significa. "Sem resposta" não significa "não cobrado": a cobrança pode ter passado e apenas a resposta foi perdida. Uma tentativa de novo sem forma para o gateway reconhecê-la é uma segunda cobrança. É para isso que uma idempotency key serve.

Idempotency key: um id enviado com uma requisição para o servidor saber diferenciar uma tentativa de novo de uma nova requisição. A mesma chave enviada duas vezes é executada uma vez, e a segunda chamada recebe a primeira resposta.

O iniciador te dá FakeGateway, um gateway que você scripta: você decide se cada cobrança passa, é recusada, não tem resposta ou é cobrada com a resposta perdida. Ele registra o que foi realmente tirado do cartão em charged, e conta calls.

Sua vez

Escreva my_test(pay), usando FakeGateway. Ele recebe uma versão de pay(gateway, order_id, amount, sleep) e deve lançar um erro se essa versão quebrar uma regra. As regras para um pagamento correto: cada tentativa envia o id do pedido como a chave; uma "declined" é resposta selada (retorne-a, sem nova tentativa); apenas uma TimeoutError é retentada, com no máximo 3 tentativas no total; antes de cada retentativa ele chama sleep(seconds) com uma espera positiva, cada uma mais longa que a anterior; ele retorna "ok", "declined", ou "failed" se todas as tentativas excederem o tempo. Passar na barra: passe a versão correta e capture pelo menos 4 das 6 versões quebradas (o conselho plantado é um deles).

Viu um problema nesta lição? Reporte-o · Pergunte sobre esta lição

Este exercício abre em breve

Termine a lição anterior para que esta seja desbloqueada. O curso inteiro é gratuito, não precisa de conta, e você pode ler esta lição agora mesmo.