Integração API
API de recebimentos USDT / USDC: criar e consultar pedidos
Use vínculos exclusivos para depósitos e pedidos de recebimento para valores fixos. Compare assinaturas, solicitações e respostas nas ferramentas oficiais.
Guia passo a passo
Siga as etapas no seu painel. Clique em uma imagem para ampliá-la.
Abra o depurador de API no centro de desenvolvedores. Para depósitos de membros, escolha Criar wallet exclusiva e siga esse guia. As etapas abaixo descrevem recebimentos de valor fixo. LIVE · Produção indica que a criação grava dados reais; você pode começar consultando um pedido existente.
Etapa 1 · Clique para ampliar Informe seu Merchant UID de seis dígitos e a API Key iniciada por mch_ na ferramenta oficial. Eles ficam apenas na memória dessa página e precisam ser informados novamente após atualizar. Não compartilhe capturas nem cabeçalhos que contenham a chave.
Escolha Criar pedido de recebimento e confira moeda, merchantOrderNo, amount e notifyUrl. Envie o valor como string; merchantOrderNo relaciona o pedido ao seu sistema. notifyUrl deve usar HTTPS. Use a URL de depuração para observar callbacks e a URL do seu serviço publicado para operações do negócio.
Confirme a criação em produção somente quando quiser criar um pedido real. A ferramenta gera timestamp, nonce e assinatura e exibe solicitação e resposta. Confira estado HTTP, orderNo, merchantOrderNo, cashierUrl e status. Um link de checkout confirma a criação, não o recebimento.
Mude para Consulta de estado e informe o orderNo da plataforma: PI para recebimentos e PO para pagamentos. Não use merchantOrderNo. Recebimentos têm sucesso em completed; pagamentos, em confirmed, ou falham em failed. Se o resultado for incerto, consulte o pedido original antes de criar outro.
Compare cabeçalhos, mensagem assinada, body e resposta original. 20005: confira a chave; 20011: caminho, ordenação e normalização; 20012: relógio; 20016: gere um novo nonce; 40105: pedidos vigentes do mesmo valor; 51004: saldo de taxas. Guarde requestId e compartilhe o erro sem dados sensíveis. Use os exemplos Node.js ou PHP e leia credenciais de variáveis de ambiente.
A ferramenta usa produção. Criar pedidos ou wallets salva dados reais; criar um pagamento de saída tenta enviar fundos. Em caso de timeout ou resultado desconhecido, consulte o pedido original antes de repetir.