Guia de integração

Por que um pagamento USDT / USDC pode continuar pendente depois do cliente pagar

Uma transação bem-sucedida na blockchain nem sempre significa que a ordem deve ser concluída. Verifique se há mismatch ou falha de webhook.

Passos

Fluxo para pagamento USDT / USDC pendente

Ideal para suporte e operações investigando ordens USDT / USDC pagas mas pendentes.

  1. 01

    Separe pagamento não detectado de app do comerciante não atualizado.

  2. 02

    Compare rede, contrato USDT / USDC, endereço, valor, expiração e confirmações.

  3. 03

    Se a ordem já foi concluída, revise logs de webhook, resposta e assinatura.

  4. 04

    Use status da ordem ou reenvio de webhook antes de cumprir manualmente.

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 pagamento pendente
PENDING     No matched payment recorded
PAID        Payment recorded, awaiting confirmation
CONFIRMED   Payment confirmed, inspect callbacks
COMPLETED   Callback received a successful response

Check your own fulfillment records separately.

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

Por que a ordem continua pendente se a transação teve sucesso?

Geralmente a transferência não corresponde à rede, contrato USDT / USDC, endereço, valor exato, confirmações ou janela de expiração da ordem.

E se a BoltUtil mostra completed, mas meu app não atualizou?

Verifique logs de webhook, códigos de resposta, validação de assinatura e lógica de cumprimento antes de reenviar o webhook.

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.