Guia de integração

Por que um webhook USDT / USDC pode funcionar apenas no retry

Quando o pagamento já está completed mas o app do comerciante atualiza só no segundo envio, o problema costuma estar no endpoint, assinatura, timeout ou lógica não idempotente.

Passos

Fluxo de diagnóstico de retry

Ideal para desenvolvedores depurando ordens USDT / USDC concluídas cujo primeiro callback falha.

  1. 01

    Confirme que a ordem está completed na BoltUtil.

  2. 02

    Compare a primeira tentativa falha com o retry bem-sucedido: status, latência, timeout e resposta.

  3. 03

    Verifique HMAC usando o raw body antes de parsear JSON.

  4. 04

    Faça o cumprimento idempotente por ID externo e tx hash, depois reenvie.

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.

Diagnóstico de retry webhook
timestamp + "." + raw_request_body
→ HMAC_SHA256 with webhook secret
→ Verify timestamp / signature
→ Validate order and payment
→ Persist and deduplicate
→ 2xx response

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

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

Retry significa que o pagamento USDT / USDC foi detectado tarde?

Não necessariamente. Se a ordem já está completed, o scanner funcionou; o retry é sobre entrega do callback.

O que meu endpoint webhook deve retornar?

Retorne 2xx depois de verificar a assinatura e registrar o evento de forma durável. Evite redirects e tarefas longas bloqueantes.

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.