Documentação

Português

English
Español

Português

English
Español

Appearance

Depósitos de Tokens ​

Pré-requisitos de acesso

  • Permissão (módulo): sendBalance + feature ADMIN_BALANCE_CONTROL
  • Status do usuário: APPROVED
  • Contêiner do menu: GERAL → grupo Usuários → Lista de usuários → olho do usuário → aba Geral → card de saldo → botão Creditar

O que é / quando usar ​

A ação Creditar saldo (depósito manual de tokens) permite que o administrador deposite tokens diretamente no saldo de um usuário pelo BackOffice. Use quando:

  • Um depósito on-chain foi detectado na blockchain mas não foi processado automaticamente pelo sistema (falha de watcher, problema de sincronismo).
  • Um reembolso ou crédito contratual precisa ser concedido manualmente.
  • O suporte identificou uma inconsistência de saldo e precisa corrigi-la com evidência.

Segurança por hash de transação (idempotência) ​

O campo Hash da transação é o principal mecanismo de segurança desta operação. Ao informar o txHash da transação blockchain:

  • O sistema garante que aquele hash só pode ser creditado uma única vez.
  • Tentativas de reprocessar o mesmo hash são bloqueadas automaticamente (E00021 — already processed).
  • O hash fica vinculado ao lançamento no histórico do usuário para auditoria futura.

Sempre informe o txHash real da transação. Para créditos manuais sem origem blockchain (ex.: bônus, compensação), use um identificador único e descritivo no campo de referência.

Como usar ​

  1. Abra os Detalhes do usuário e acesse o card de saldo na aba Geral.
  2. Clique em Creditar (visível apenas com sendBalance + ADMIN_BALANCE_CONTROL).
  3. Selecione a moeda/token a ser creditado.
  4. Informe o valor (tratado como BigNumber — respeite as casas decimais do token).
  5. Informe o hash da transação blockchain (ou um identificador único para créditos manuais sem origem on-chain).
  6. Confirme a operação.

Campos do modal ​

CampoDescriçãoObrigatório
Token / MoedaCripto a ser creditada (ex.: BTC, ETH, tBRL, token do tenant)Sim
ValorQuantidade a creditar (BigNumber, casas decimais do token)Sim
Hash da transaçãotxHash da operação blockchain ou ID de referência únicoSim
ObservaçãoMotivo/contexto para registro de auditoriaRecomendado

Efeitos no sistema ​

  • O valor é somado ao saldo disponível do usuário no token selecionado imediatamente.
  • Um lançamento do tipo CREDIT é registrado na aba Histórico → Transações.
  • O hash é marcado como processado — reenvio com o mesmo hash retorna E00021 (trate como sucesso, não repita).

Sem rollback automático

Créditos manuais movimentam saldo real. Confira token, valor e hash antes de confirmar. Para desfazer, será necessário um Débito manual de mesmo valor com a referência do crédito original.

Telas relacionadas ​