API de recebimentos USDC: integração BEP20 e Solana

2026-07-11 · Atualizado 2026-10-01 · UUGate · 3 min de leitura

USDC atende produtos digitais, assinaturas e membros com usuários de BSC ou Solana. Identifique primeiro as redes disponíveis. O mesmo nome do ativo não torna transferências entre redes equivalentes.

Escolha a rede e o modelo

São suportados BSC-USDC (BEP20) e SOL-USDC (SPL), com chainCode=BSC e SOL. Configure wallet compatível e mostre rede, endereço e valor juntos. TRON-USDC e redes futuras não estão disponíveis.

Parâmetros e etapas de integração

Para compra com valor fixo use POST /openapi/payin/orders. Guarde merchantOrderNo, orderNo, address, cashierUrl e expireAt antes de abrir o checkout retornado. Para recargas contínuas, considere vínculo exclusivo.

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

Status, callbacks e exceções

Espera e confirmação não significam entrega concluída. Recebimento bem-sucedido usa completed. Compense callbacks ausentes com GET /openapi/payin/orders/{orderNo}. Pagamento insuficiente, ativo ou rede errada e envio tardio exigem análise, sem promessa de recuperação entre redes.

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: produto de 10.00 USDC. Crie pedido BSC e guarde referência. Verifique callback completed e grave pagamento e uma autorização de download na mesma transação. Callback repetido não autoriza novamente; timeout exige consulta ao pedido original. É ilustração, não pagamento de cliente.

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.