Finalidade de pagamentos em cripto na TRON, BNB Smart Chain e Ethereum

Entenda blocos solidificados, cabeçalhos finalizados e épocas: quando o callback confirmado da Suawave permite concluir um pedido.

Publicado em , atualizado em

Blocos de vidro azuis, transparentes e vermelhos representam as etapas de confirmação de um pagamento

A finalidade é o ponto em que o bloco de um pagamento atende à regra de confirmação definitiva da rede. Uma transação aparecer na carteira ou em um bloco recente não significa que chegou a esse ponto. Na Suawave, há mais uma etapa: encaminhar o depósito elegível e confirmar a transação de saída antes de enviar o callback confirmado.

Isso explica por que a carteira pode mostrar “enviado” enquanto a loja mostra “aguardando”. São etapas diferentes. O checkout deve nomeá-las, sem prometer um horário exato de conclusão.

O que confirmado significa para a loja?

Na API pública, pending igual a "0" significa que o depósito foi encaminhado e o repasse foi confirmado. Verifique assinatura, pedido, duplicidade e valor antes de marcar como pago ou programar a entrega.

Com pending=1 na criação do endereço, um depósito elegível detectado também pode gerar pending igual a "1". A detecção vem dos dados indexados da rede, não de uma assinatura separada de mempool. Serve para mostrar progresso, sem autorizar entrega.

Etapa O que comprova O que mostrar
Endereço criado Destino atribuído Aguardando pagamento
Depósito elegível detectado Transferência vista pelo indexador Pagamento detectado
Verificações de finalidade concluídas Evidência de entrada atende à política Aguardando repasse
Repasse confirmado Transação de saída confirmada Avaliar o callback confirmado

O guia de callbacks define os eventos públicos. Não existe um callback separado para cada etapa interna da tabela.

Por que esperar antes de creditar?

Imagine um pagamento de 40 USDT incluído no bloco 1.000. Se a rede substituir esse bloco recente, a transferência aparente pode desaparecer da cadeia canônica. Creditar na primeira observação transforma evidência provisória em saldo da loja.

A verificação EVM da Suawave compara o recibo com o cabeçalho canônico e a ponta finalizada, confere contrato do token, participantes e valor inteiro e rejeita logs removidos. Na TRON, exige execução bem-sucedida e evidência de recibo solidificado correspondente. Um hash de sucesso, sozinho, não comprova o token, destino e valor esperados.

Uma captura de tela pode mostrar outro ativo ou uma transferência ainda não aceita. Use o hash para investigar, mas vincule as alterações do pedido à evidência verificada.

Como funciona a solidificação da TRON?

A TRON separa a ponta mais recente da ponta solidificada. Um bloco fica solidificado quando pelo menos 19 dos 27 Super Representatives ativos construíram sobre ele. Segundo o glossário da TRON, a ponta solidificada costuma ficar cerca de um minuto atrás.

O registro da Suawave usa intervalo de três segundos e política solidified. Três segundos é intervalo entre blocos, não prazo de pagamento. Sem recibo de solidificação, o depósito continua aguardando, mesmo que uma amostra anterior da ponta pareça alta o suficiente. A inclusão em um full node não basta.

Dezenove confirmações equivalem à solidificação?

Não. A regra depende de produtores distintos construindo sobre o bloco. Um contador genérico de confirmações não expressa isso. A Suawave acompanha a visão solidificada. Depois, preparar recursos e enviar USDT ainda leva tempo.

Como a BNB Smart Chain usa finalized?

Na mainnet BSC, a Suawave seleciona finalized_tag e habilita cabeçalhos finalizados. O bloco do recibo precisa estar na cadeia canônica e no máximo na altura da ponta finalizada válida.

A documentação RPC da BNB Chain distingue latest, safe e finalized. Um recibo em latest ainda pode não estar coberto por finalized.

O intervalo configurado é de 450 milissegundos. O guia de tickers descreve confirmação típica após inclusão em menos de um minuto. Nenhum desses números inclui todas as etapas de repasse e entrega do callback.

Posso pedir menos confirmações?

O create público não aceita número de confirmações escolhido pelo cliente nem prioridade para acelerar a política. Consulte os parâmetros da referência da API. O contador no callback é informativo; a lógica do pedido deve seguir o significado documentado do evento.

Como as épocas da Ethereum afetam a finalidade?

A mainnet Ethereum ainda não está habilitada na Suawave. A disponibilidade de Sepolia não a torna uma opção de checkout. A comparação serve para explicar a arquitetura.

A documentação de proof of stake da Ethereum define slots de 12 segundos e épocas de 32 slots: 384 segundos, ou 6,4 minutos. Validadores votam em checkpoints; a finalidade depende desse consenso, não de um único bloco de execução.

O guia de tickers indica cerca de 13 minutos após inclusão como expectativa típica, sem garantir exatamente duas épocas. A entrada desabilitada da mainnet usa a política de cabeçalhos finalizados. Não transforme esses valores em um contador que marque pedidos como pagos: tempo decorrido não substitui evidência finalizada.

O que mostrar enquanto o pagamento aguarda?

Mantenha uma página que sobreviva a atualizações, com ticker, endereço e estado salvos no servidor. Um callback pendente pode indicar detecção e evitar um segundo envio desnecessário.

A URL de retorno do navegador apenas exibe o estado do servidor. Voltar da carteira, escanear QR ou clicar em “já paguei” não deve quitar o pedido. Veja o passo a passo USDT.

Um evento pendente atrasado não pode desfazer uma confirmação. Eventos pendente e confirmado têm UUIDs diferentes; novas tentativas mantêm o UUID do evento. O guia de webhooks explica o processamento durável.

Como investigar um pagamento parado?

Confira rede, ativo, endereço, hash, mínimo e janela de aceitação. Transferências abaixo do mínimo ou atrasadas podem não gerar callback; esperar mais não muda a elegibilidade. Consulte pagamentos menores e atrasados.

Nos logs consultados com o callback original, pending significa repasse não confirmado, sent significa repasse confirmado sem reconhecimento do callback e done significa callback reconhecido. Isso separa demora do pagamento de falha de entrega.

Compare a rota inteira em USDT TRC20 e BEP20. Mantenha a referência e a evidência disponíveis ao suporte e aguarde até que a política de valores seja atendida.