Guia de integração

Como verificar um pagamento USDT / USDC antes de cumprir uma ordem

Quando um cliente diz que pagou mas a ordem continua pendente, compare fatos on-chain com os dados da ordem usando um fluxo repetível.

Passos

Fluxo de verificação de pagamentos USDT / USDC

Ideal para suporte e desenvolvedores que precisam decidir se uma transferência USDT / USDC real deve concluir uma ordem.

  1. 01

    Confirme a rede escolhida pela ordem.

  2. 02

    Abra o explorer correto e verifique se é um Transfer de USDT / USDC.

  3. 03

    Compare o endereço de destino com a carteira da ordem.

  4. 04

    Compare o valor normalizado antes de cumprir a ordem ou reenviar webhook.

BoltUtil verifica pagamentos e envia callbacks assinados. Seu servidor valida assinatura e estado, elimina duplicados e depois entrega, ativa ou credita.

Notas de integração

O que importa antes da produção

Liquidação não custodial

Os fundos vão direto para a carteira do comerciante. A BoltUtil monitora a blockchain e envia notificações.

Cinco redes USDT / USDC

Aceite TRC20, ERC20, BEP20, Polygon e Solana com uma única API de pedidos e payload de webhook unificado.

Automação por webhook

Quando o pagamento é detectado e confirmado, seu backend recebe uma chamada assinada para cumprir o pedido.

Checklist de verificação manual
Network matches the order
Configured token contract / mint matches
Destination matches the order wallet
Full payable amount matches
Payment time and order window checked
Required confirmations reached
Transaction association and fulfillment checked

Exemplos de integração e diagnóstico. Nenhuma solicitação é enviada. Use seus pedidos, configuração de rede e documentação da API.

Ler documentação da API

O que verificar a seguir

Guarde o pedido original e o hash. Transferência bem-sucedida, pagamento confirmado e webhook entregue são etapas diferentes.

Com A = 1.000, B = 1.010 e C = 1.020, um pagamento de 1.020 corresponde a C somente se as demais condições forem atendidas. Para 1.030 não há correspondência exata.

Exemplo ilustrativo. Diferenças não são aceitas automaticamente: confira regras, prazo e vínculo. Contas gratuitas consultam suas análises; aceitar ou rejeitar o vínculo exige Pro ativo.

Valor exato
Compare valor completo, rede, token, carteira e prazo. Uma correspondência exata válida tem prioridade sobre candidatos com diferença.
Pagamento a menos ou a mais
Uma transferência manual elegível pode gerar uma análise. Verifique limites e vínculo; não escolha apenas o pedido de valor mais próximo.
Pagamento em confirmação
PAID indica pagamento registrado e confirmação em andamento. Verifique a rede e a leitura da cadeia sem pedir novo pagamento.
Pagamento confirmado, loja sem atualização
Confira webhook, resposta HTTP, assinatura do corpo original e persistência do pedido. Corrija o receptor, reenvie conforme as permissões e entregue uma única vez.
Rede ou token incorreto
Verifique a rede e o contrato ou mint. Mesmo símbolo ou formato de endereço não transforma uma transferência de outra rota no pagamento deste pedido.

Liquidação não custodial

Os fundos vão direto para a carteira do comerciante. A BoltUtil monitora a blockchain e envia notificações.

Cinco redes USDT / USDC

Aceite TRC20, ERC20, BEP20, Polygon e Solana com uma única API de pedidos e payload de webhook unificado.

Automação por webhook

Quando o pagamento é detectado e confirmado, seu backend recebe uma chamada assinada para cumprir o pedido.

Guia de integração

Perguntas antes de ir para produção

A BoltUtil custodia fundos do comerciante?

Não. A BoltUtil é uma camada não custodial de monitoramento e notificação. O comerciante usa sua própria carteira.

Como a BoltUtil vincula um pagamento a uma ordem?

O sistema valida rede, endereço de destino, valor exato em USDT / USDC, status da ordem e janela de expiração.

Quais redes aceitam USDT e USDC?

TRON aceita apenas USDT. Ethereum, BNB Smart Chain, Polygon, Solana e Base usam as versões configuradas de USDT / USDC. A disponibilidade depende dos canais ativos e das carteiras do comerciante.

Lance um fluxo de pagamento USDT / USDC mais limpo

Crie ordens, monitore transferências e notifique seu backend sem pedir comprovantes manuais.