API de recarga USDT para membros: vínculo e conciliação
Recargas precisam identificar o dono do depósito. Uma compra fixa usa pedido; saldo contínuo pode usar endereço exclusivo ligado a um identificador estável de membro.
Escolha a rede e o modelo
USDT é suportado em TRON (TRC20) e BSC (BEP20). Guarde bindKey, rede, ativo, bindingId e endereço. Depósitos de membros e recargas da conta de custos do comerciante são fluxos distintos; não use o endereço de custos da plataforma.
Parâmetros e etapas de integração
Crie ou reutilize POST /openapi/payin/exclusive-bindings. bindKey vem do identificador estável e notifyUrl do seu callback HTTPS. Consulte GET /openapi/payin/exclusive-bindings/{bindKey}?chainCode=TRON&tokenSymbol=USDT&recentLimit=10. bindKey não é orderNo.
Este corpo é ilustrativo: nenhuma solicitação é enviada e não há dados reais. A chamada completa exige UID, API Key, timestamp, nonce e assinatura no servidor. Envie valores como strings e use aritmética exata na contabilidade.
{
"chainCode": "TRON",
"tokenSymbol": "USDT",
"bindKey": "MEMBER_DEMO_001",
"label": "Demo member",
"notifyUrl": "https://merchant.example.com/member-topups/notify"
}Status, callbacks e exceções
Cada depósito gera um registro. Confira membro, completed, paidAmount e rede antes de creditar. stats acumulados não são o novo valor. Confira recentOrders e consulte cada pedido; compensação usa a mesma deduplicação.
Se a criação do recebimento expirar sem orderNo, confira a operação original no painel. Não suponha que merchantOrderNo garante novas tentativas idempotentes. Com orderNo, consulte esse pedido. Deduplicar callbacks é diferente de repetir a criação.
Use a API Key do pedido original e o rawBody sem alterações. Valide HMAC-SHA256(timestamp + "." + nonce + "." + rawBody) contra x-callback-signature. Depois confira identidade, pedido, ativo, rede e valor. Transação de banco e restrição única impedem créditos duplicados. Retorne HTTP 2xx após persistência confiável; redirecionamento não confirma pagamento.
Exemplo ilustrativo de integração
Exemplo: MEMBER_DEMO_001 deposita 10.00 e 5.00 USDT em TRON. Dois pedidos verificados creditam 15.00. Repetir o segundo callback não adiciona outros 5.00. Não há membro nem pagamento real; valide sua implementação antes de abrir.
Verificações antes do lançamento
- Assinatura válida passa; alterar o corpo original invalida a verificação.
- Callback duplicado credita uma vez; processamento interrompido pode ser retomado.
- Consulta, callback, lançamentos e transação na rede conferem.
- Rede errada, valor anormal, expiração e resultado desconhecido exigem investigação.
Integração e referências técnicas
- Parâmetros da API
- Assinatura de solicitações
- Verificação de callbacks
- Planos e custos de rede
- Tutorial relacionado
- API de pagamentos USDT
- API de pagamentos USDC
- Recebimentos com endereço exclusivo
- SDK Node.js
- SDK PHP / Laravel
- TRON: TRC-20 protocol interface
As fontes explicam padrões e métodos técnicos; não representam endosso à UUGate. Os parâmetros aplicáveis estão na documentação atual da UUGate.