Uma intenção, uma referência
Mantenha uma referência estável por intenção de pagamento. Antes de repetir uma chamada que expirou, consulte o estado da operação quando o provedor permitir. Confirme na documentação da API quais garantias de idempotência existem.
Eventos podem chegar fora de ordem
Projete consumidores capazes de reconhecer eventos repetidos e transições inválidas. Registre identificadores e horários sem colocar credenciais ou dados sensíveis desnecessários nos logs.
Confirmação e reconciliação
Uma resposta de recebimento não equivale à liquidação. Separe estados técnicos e financeiros e compare a execução com os registros bancários. Este guia descreve padrões de arquitetura; endpoints e recursos precisam ser confirmados na documentação da Openi.
