Comece com um pedido identificável
Um checkout deve começar com um valor e uma descrição claros. No fluxo de pedido documentado da Coino Live, o comerciante envia o valor em USD, a URL de callback, a descrição e o ID do gateway. O ID do pedido retornado vincula a página de pagamento do cliente a essa solicitação. Guarde a referência no seu próprio sistema de pedidos para que uma solicitação de conta ou de suporte possa ser associada à compra correta.
Separe a escolha do ativo da escolha da rede
O pagador primeiro escolhe um ativo e, em seguida, uma rede disponível para esse ativo. O símbolo sozinho não é uma instrução de pagamento completa: a rede selecionada também importa. Compare a rede exibida no checkout com a carteira de envio. O diretório de moedas é útil para explorar, mas é a API de pagamento que determina quais opções estão disponíveis para a solicitação real.
Mantenha o status do pagamento e do pedido separados
Abrir o checkout, voltar de uma página ou criar um pedido não comprova, por si só, a conclusão do pagamento. Seu servidor deve verificar o resultado oficial antes de processar o pedido. Os status "aguardando pagamento" e "em confirmação" precisam de uma explicação clara para que o cliente não presuma que toda tela pendente significa um depósito com falha.
Ofereça um próximo passo útil para cada resultado
Um resultado confirmado pode levar o pagador de volta ao comerciante. Uma solicitação expirada pode abrir um novo checkout, enquanto um erro de consulta deve explicar que o status é desconhecido. Se o pagador já enviou fundos, ele deve guardar a referência do pedido e buscar ajuda antes de repetir a transferência. As telas de status de demonstração ilustram esses resultados sem processar um pagamento real.