Depois do pagamento: transforme cada recebimento em um serviço entregue
O pagamento chegou. Por que o cliente ainda espera?
Um cliente paga 100 USDT por uma assinatura. O checkout confirma o pagamento, mas o acesso permanece inativo. A interrupção pode ocorrer na notificação, na associação do pedido ou na ativação do benefício.
Registre três resultados distintos: pagamento confirmado, notificação recebida de forma confiável e serviço entregue. Isso ajuda o suporte a explicar o andamento e permite retomar tarefas interrompidas.
Separe pagamento e entrega
O estado do pagamento descreve o recebimento. O estado da entrega descreve crédito em conta, ativação de assinatura ou entrega de produto digital. Mantenha estados e horários independentes.
Se a ativação falhar após a confirmação, mostre “Pago, ativação em processamento”. Preserve o pagamento confirmado e a tarefa pendente. Não volte o pedido para aguardando pagamento nem peça que o cliente pague novamente.
Receba com segurança antes de entregar
Verifique a assinatura conforme a documentação da UUGate e valide titularidade do pedido, ativo, rede, valor e estado. Um redirecionamento do navegador ou uma captura da transferência não substitui a verificação no servidor.
Persista o evento validado e a tarefa antes de responder conforme a documentação. A entrega demorada pode ser executada depois. Um evento mantido apenas em memória pode desaparecer após uma reinicialização.
Um pedido, um único resultado
Notificações podem se repetir. Use uma restrição única combinando comerciante e pedido, com transações ou atualizações condicionais, para evitar créditos, entregas ou períodos de assinatura duplicados.
Ao chamar serviços externos, reutilize um identificador de idempotência estável e salve a resposta. Um timeout não comprova falha: consulte o resultado anterior ou use o mecanismo de idempotência do serviço antes de tentar novamente.
Dê um próximo passo às exceções
Mantenha uma lista consultável de pedidos pagos e não entregues, com último erro, horário da tentativa e resultado. Separe falhas temporárias de divergências de pedido ou valor que exigem análise.
Relacione o pedido da plataforma, o pedido do comerciante, o hash e o registro de entrega. A recuperação manual deve usar a mesma deduplicação e auditoria. Concilie separadamente o saldo real em blockchain e a conta de tarifas; registros de entrega não determinam saldo.
Teste interrupções antes de lançar
- Um pagamento normal entrega o serviço uma única vez.
- Notificações repetidas não duplicam créditos ou entregas.
- Tarefas persistidas sobrevivem à reinicialização.
- Timeouts externos são resolvidos sem entrega duplicada.
- Pagamentos confirmados com falha na entrega mostram processamento e uma forma de consultar o andamento.
A UUGate fornece pagamentos e notificações; o sistema do comerciante transforma os resultados verificados no serviço contratado. O teste deve ir até o cliente receber esse serviço.
Documentação da UUGate · Recuperação de webhooks
Referência geral: Documentação de webhooks da Stripe. Para assinaturas, campos e respostas da UUGate, siga a documentação da UUGate.