Wallet exclusiva para depósitos — recomendada

Guia passo a passo

Siga as etapas no seu painel. Clique em uma imagem para ampliá-la.

1. 1

   Para recarregar o saldo de membros, recomendamos uma wallet exclusiva. Vincule um endereço a cada membro para que ele possa fazer vários depósitos. Não é preciso informar o valor antes, e não há contagem regressiva para pagar. Isso evita problemas de correspondência por valor diferente ou pedido expirado. Rede, moeda e confirmações ainda precisam ser verificadas.

   

2. 2

   Abra a lista de wallets, clique em Criar wallet, escolha a moeda e a rede e selecione Wallet exclusiva. Se o membro envia USDT pela rede TRON, escolha TRC20-USDT. A rede deve sempre corresponder à rede do envio. TRC20-USDT · BEP20-USDT · BEP20-USDC · SPL-USDC.

   

3. 3

   Na informação de vinculação, informe um identificador estável e único do membro. Esse valor corresponde ao bindKey da API, não ao UID do comerciante. Para creditar o saldo automaticamente, informe a URL de callback do seu servidor. Se ficar vazia, será usada a configuração padrão. Confira a cota antes de criar a wallet. Por exemplo, MEMBER_10001 identifica o membro. notifyUrl deve ser uma URL HTTPS pública. Não forneça ao membro o endereço de recarga de taxas.

   

4. 4

   Filtre a lista por Wallet exclusiva e confira a moeda e o endereço do membro. Wallets criadas pela API também aparecem aqui. Para o mesmo membro, rede e moeda, reutilize a vinculação existente. Não crie uma nova wallet a cada depósito.

   

5. 5

   Abra o checkout na linha da wallet. Não há campo de valor nem contagem regressiva. Envie o endereço completo ou o link ao membro correspondente. Ele escolhe quanto depositar, e seu sistema credita o valor realmente recebido. Mantenha a wallet habilitada para receber depósitos. Antes de desativá-la, avise o membro para parar de enviar fundos ao endereço.

   

6. 6

   Para integrar pela API, abra a ferramenta oficial e selecione Criar wallet exclusiva. Informe a moeda, o identificador do membro e a URL de callback. Não são necessários valor, prazo ou número de pedido do comerciante. O pedido é gerado quando o depósito é detectado. POST /openapi/payin/exclusive-bindings · chainCode · tokenSymbol · bindKey · label? · notifyUrl?

   

7. 7

   Autentique no servidor com Merchant UID + API Key e os cabeçalhos x-api-key, x-merchant-uid, x-timestamp, x-nonce e x-signature. A mensagem HMAC-SHA256 tem sete linhas: UID, timestamp em milissegundos, nonce, método HTTP em maiúsculas, caminho sem query, query normalizada e body normalizado. Use o SDK oficial ou o código da ferramenta e gere um timestamp e nonce novos por requisição. Confira os dados antes de criar uma vinculação real.

   

8. 8

   Salve bindingId, addressId, address, bindKey, chainCode, tokenSymbol e status; o status deve ser active. A mesma combinação de comerciante + rede + moeda + bindKey retorna a vinculação existente. Repetir a criação não substitui label nem notifyUrl. A resposta não inclui cashierUrl: mostre address na sua página de depósitos ou copie o link do checkout no painel.

9. 9

   Consulte com GET /openapi/payin/exclusive-bindings/{bindKey}?chainCode=TRON&tokenSymbol=USDT&recentLimit=10. Codifique bindKey para uso na URL. GET não tem body, mas a query participa da assinatura. A resposta contém stats, recentOrders e recentTransactions. recentLimit aceita de 1 a 20 e não substitui o histórico contábil completo. Para um pedido específico, use GET /openapi/payin/orders/{orderNo}.

10. 10

    Depois de processar o depósito, a plataforma envia o callback para notifyUrl da wallet ou para a configuração padrão, se estiver vazio. Verifique rawBody com a API Key associada ao pedido e confira comerciante, rede, moeda, bindKey e status=completed. Credite paidAmount, o valor efetivamente recebido. Use (merchantUid, orderNo) como chave única e grave a deduplicação e o aumento do saldo na mesma transação de banco de dados. Retorne HTTP 2xx após o sucesso. Confirme duplicidades sem creditar novamente. Não deduplique apenas por bindKey: isso descartaria o próximo depósito do membro.

    

11. 11

    Nos pedidos de recebimento, filtre por endereço, etiqueta ou identificador de vinculação. Confira o valor, o status e o hash. A API também consulta pedidos e transações recentes da vinculação e os detalhes de um pedido. Abaixo, a parte escrita mostra as rotas e os exemplos. Confira o resultado com o registro da wallet e o saldo do membro no seu sistema. O botão Callback reenvia uma notificação; não abre uma consulta. Garanta a deduplicação antes de usá-lo.

    

12. 12

    Se o saldo do membro não mudar, confira rede, moeda e confirmações. Depois, verifique o pedido, a URL de callback e os registros do seu servidor. Se a assinatura falhar, confira a normalização, o relógio e nonce. Se a vinculação não aparecer, confira comerciante, rede, moeda e bindKey. Verifique também o status da conta, a cota de endereços e o saldo de taxas.