Endereços exclusivos e compartilhados para USDT / USDC

2026-06-16 · Atualizado 2026-10-01 · UUGate · 3 min de leitura

Compra pontual e saldo recorrente exigem vínculos diferentes. Escolha pelo objeto de negócio, identificação do valor e autoridade de assinatura, não apenas pela permanência do endereço.

Escolha a rede e o modelo

Pedidos compartilhados de valor fixo ligam referências do comerciante e da plataforma, respeitando validade e ocupação de valores. Pedido ativo de mesmo valor pode retornar 40105. O vínculo exclusivo liga bindKey, rede, ativo e endereço.

Parâmetros e etapas de integração

Use POST /openapi/payin/orders para compra fixa e POST /openapi/payin/exclusive-bindings para recargas. Combinações: TRC20-USDT, BEP20-USDT, BEP20-USDC e SPL-USDC. Mudar o modelo não acrescenta redes.

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",
  "merchantOrderNo": "DEMO_PRODUCT_001",
  "amount": "10.00",
  "notifyUrl": "https://merchant.example.com/payments/notify"
}

Status, callbacks e exceções

Vínculo de negócio não concede assinatura. Wallets custodiais geradas pela plataforma podem pagar conforme permissões. Endereços importados apenas para observação são monitorados, mas a plataforma não pode assinar saídas deles.

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: compra de 10.00 USDT recebe pedido e checkout. MEMBER_DEMO_001 guarda vínculo para depósitos futuros. Ambos terminam em crédito verificado uma única vez, mas a consulta do titular e o vínculo com pedido permanecem distintos.

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

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.