Monitoramento de endereços USDT e avisos: observação e recargas de membros
O monitoramento de endereços USDT acompanha atividade na blockchain. Avisos de recebimento conectam pagamentos confirmados ao negócio. Variação de saldo, pedido concluído e crédito ao membro são eventos distintos.
Observe um endereço existente
Adicione um endereço externo da rede adequada para observar recebimentos ou usá-lo como destino de agrupamento. A chave privada não é importada e a plataforma não pode assinar pagamentos a partir dele. Ele não substitui endereços exclusivos por membro. Veja tipos de carteira.
USDT usa TRC20 ou BEP20; USDC usa BEP20 ou SPL. Confira ativo e rede. Endereços de recarga de taxas pertencem à conta de taxas, não ao recebimento de clientes.
Monitoramento não identifica o membro
Várias pessoas podem transferir para o mesmo endereço. O saldo maior não identifica membro ou fatura. Use o fluxo de pedidos ou vinculação e preserve a relação entre negócio e pagamento.
Observar endereços externos não garante webhook personalizado para qualquer transação. Os callbacks pertencem ao fluxo de recebimento ou recarga aplicável, conforme a documentação.
Vincule o membro por bindKey
Obtenha um bindKey estável do membro autenticado no servidor e crie ou consulte a vinculação por comerciante, rede e ativo. Salve bindingId, addressId, address e bindKey. Repetir a vinculação pode reutilizar o resultado, mas não altera label ou notifyUrl.
A API não retorna cashierUrl. Use sua página de recarga ou copie o link do painel. Siga o tutorial exclusivo.
Credite notificações com segurança
Após confirmação e processamento, o recebimento exclusivo gera pedido e callback. Valide rawBody com a API Key original e confira comerciante, orderNo, rede, ativo, bindKey, completed e paidAmount.
Crie registro único por comerciante e orderNo. Deduplicação e atualização de saldo devem ocorrer na mesma transação antes de responder HTTP 2xx. Usar apenas bindKey descartaria a segunda recarga válida. Veja o protocolo.
Investigue recebimento sem aviso
Confira rede, token, destino e confirmações; depois vinculação ativa, pedido, notifyUrl, assinatura e logs. Consulte o pedido original ou os pedidos e transações recentes da vinculação.
O botão de callback no painel reenvia a notificação. Use após reparar o receptor e confirmar idempotência; não é um visualizador de logs. Veja recuperação.
Concilie saldo e recebimentos
O RPC real da blockchain é a referência do saldo. Instantâneos e registros ajudam a rastrear movimentos. Falha significa saldo desconhecido, não zero. Agrupamentos, pagamentos e outras transferências alteram o saldo atual.
- Guarde horário, rede, ativo, pedido e evidências.
- Registre confirmação, recepção do aviso e crédito separadamente.
- Avise antes de desativar ou alterar carteiras e preserve o histórico de titularidade.
Veja conciliação.
Escolha o fluxo adequado
Para observar endereços, comece pelos tipos de carteira; para recargas, por endereços exclusivos; para pedidos fixos, pela API USDT. Compare entradas no guia de checkout.