API de pagamentos USDT / USDC: custos e resultados desconhecidos
O pagamento termina quando confirmação na rede e liquidação comercial coincidem. Confira fundos, custos, destino e referência antes de criar e mantenha os estados posteriores.
Escolha a rede e o modelo
A API pública oferece pagamento individual; lotes ficam no painel. Rotas: TRON-USDT, BSC-USDT, BSC-USDC e SOL-USDC. Destino deve corresponder à rede e não ser wallet própria do comerciante. Wallet de observação não assina pagamentos.
Parâmetros e etapas de integração
POST /openapi/payout/orders recebe rede, ativo, amount, toAddress, merchantOrderNo e notifyUrl. fromAddress é opcional; a plataforma pode escolher origem suficiente. Troque o destino ilustrativo por endereço verificado. Mantenha desativada a exclusão do endereço de origem por padrão.
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",
"toAddress": "REPLACE_WITH_VERIFIED_TRON_ADDRESS",
"amount": "35.50",
"merchantOrderNo": "DEMO_PAYOUT_001",
"notifyUrl": "https://merchant.example.com/payouts/notify"
}Status, callbacks e exceções
Guarde o orderNo PO e consulte GET /openapi/payout/orders/{orderNo}. confirmed é sucesso; failed é falha. submitted, broadcasted e desconhecido não concluem liquidação. Não troque referências para pagar novamente; verifique a transação assinada original quando o resultado for incerto.
O principal da wallet e a conta de custos são separados. Antes de pagar, confira saldo real de origem e custos de rede suficientes. Saldo de custos negativo bloqueia operações críticas. Consulte preços, quotas e custos atuais; estimativas de gas não são a cobrança da UUGate.
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: liquidação de 35.50 USDT para parceiro. Salve orderNo; após interrupção de rede consulte o pedido original e registre uma liquidação quando confirmed. Resultado desconhecido continua pendente enquanto txHash é conferido. Investigue falhas antes da recuperação documentada. Nenhum fundo foi enviado.
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
- Node.js: HMAC and timing-safe comparison
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.
Pagamentos USDT em lote: painel, taxas e resultados
A API pública oferece apenas pagamentos individuais. Pagamentos USDT em lote são feitos no painel do comerciante. Repetir solicitações individuais não equivale a API de lote atômico nem garante sucesso ou reversão de todo o lote.
Siga o tutorial, confira cada destino e rede, fundos de origem e saldo de taxas suficiente para o lote inteiro. Complete a 2FA exigida. Principal da carteira e conta de taxas são verificados separadamente.
Concilie registro, estado e hash de cada pagamento. Em falhas parciais ou resultado desconhecido, preserve e consulte os registros originais. Se já assinado, verifique ou retransmita a assinatura original; não assine novo pagamento que possa duplicar o envio.