Citrine Market pede que você investigue cobranças duplicadas depois de timeouts de rede. A taxa fictícia de checkouts é de 120/s. Entregue um modelo de intenção de pagamento, uma API de status e um quadro de conciliação com o provedor. O design aceito precisa lidar com cliques repetidos, respostas perdidas, eventos duplicados do provedor e um evento pendente tardio depois da confirmação.
Citrine Market precisa acabar com as cobranças duplicadas sem tratar um timeout como um pagamento recusado. Um provedor pode aceitar uma cobrança e perder a resposta. O próximo clique do cliente pode então parecer uma nova tentativa, embora o dinheiro já tenha se movido. Comece por uma intenção de pagamento durável cuja identidade sobreviva aos dois cliques.
O provedor e o seu banco de dados de pedidos não compartilham uma transação. Mantenha explícita a máquina de estados do pagamento: criado, pendente, confirmado, recusado ou incerto. Um webhook pode chegar antes da resposta síncrona, e o próprio webhook pode se repetir. Você vai modelar a intenção, construir o limite com o provedor e escolher uma política de conciliação. Confirme o pedido somente a partir de um resultado de pagamento verificado e depois preserve as evidências do livro-razão necessárias para explicar o resultado mais adiante.
Concilie resultados de pagamento ambíguos sob uma única intenção durável.