
Integração com Cliente JavaScript
Tipado e sem dependências de execução. Chama a API no Node ou no navegador e verifica callbacks no Node.
Leia o guia de início rápido da APIRequisitos
- Node 20+ ou navegador com fetch. A verificação de assinaturas de callbacks exige Node e usa node:crypto.
- URL base do gateway, carteira de recebimento e URL pública de callback. Chamadas públicas não exigem chave de API.
Instalação e configuração
- Instale @suawave/gateway-client na aplicação. O pacote oferece ESM, CommonJS e declarações de tipos sem dependências de execução.
- Crie GatewayClient com baseUrl e use publicCreate com ticker, endereço de repasse e URL de callback exclusiva por pedido.
- Use publicQrCode, publicLogs, publicInfo, publicEstimate e métodos de conversão conforme seu fluxo de pagamento.
- No servidor Node, importe verifyCallbackSignature de @suawave/gateway-client/verify. Obtenha publicCallbackKey e armazene em cache; verifique a URL GET completa exata ou o corpo bruto POST antes de aplicar o callback.
O que o cliente vê
Sua aplicação exibe endereço, valor em tokens e QR retornados. O cliente não adiciona um método à loja nem atualiza pedidos automaticamente; você implementa a tela e o processador de callbacks.
Como o pagamento funciona
- Valores são strings decimais. Use os auxiliares de unidades básicas para aritmética inteira, em vez de valores number do JavaScript.
- Cada operação aceita um sinal de cancelamento e as requisições têm timeout configurável. Os auxiliares de assinatura ficam no ponto de entrada verify, exclusivo do Node, permitindo empacotar o cliente principal para navegadores.
Redes e taxas para pagamentos em USDT · Guias de integração de pagamentos