Depósitos de Tokens

Requisitos de acceso

• Permiso (módulo): sendBalance + feature ADMIN_BALANCE_CONTROL
• Estado del usuario: APPROVED
• Contenedor del menú: GENERAL → grupo Usuarios → Lista de usuarios → icono de ojo → pestaña General → tarjeta de saldo → botón Acreditar

Qué es / cuándo usar

La acción Acreditar saldo (depósito manual de tokens) permite al administrador depositar tokens directamente en el saldo de un usuario desde el BackOffice. Úsela cuando:

• Se detectó un depósito on-chain en la blockchain pero el sistema no lo procesó automáticamente (falla del watcher, problema de sincronización).
• Se debe conceder manualmente un reembolso o crédito contractual.
• El soporte identificó una inconsistencia de saldo y necesita corregirla con evidencia.

Seguridad por hash de transacción (idempotencia)

El campo Hash de transacción es el principal mecanismo de seguridad de esta operación. Al proporcionar el txHash de la transacción blockchain:

• El sistema garantiza que ese hash solo puede acreditarse una vez.
• Los intentos de reprocesar el mismo hash son bloqueados automáticamente (E00021 — already processed).
• El hash queda vinculado al registro en el historial del usuario para auditoría futura.

Siempre proporcione el txHash real de la transacción. Para créditos manuales sin origen blockchain (ej.: bonificaciones, compensaciones), use un identificador único y descriptivo en el campo de referencia.

Cómo usar

1. Abra los Detalles del usuario y acceda a la tarjeta de saldo en la pestaña General.
2. Haga clic en Acreditar (visible solo con sendBalance + ADMIN_BALANCE_CONTROL).
3. Seleccione la moneda/token a acreditar.
4. Ingrese el monto (tratado como BigNumber — respete los decimales del token).
5. Ingrese el hash de la transacción blockchain (o un identificador único para créditos manuales sin origen on-chain).
6. Confirme la operación.

Campos del modal

Campo	Descripción	Obligatorio
Token / Moneda	Cripto a acreditar (ej.: BTC, ETH, tBRL, token del tenant)	Sí
Monto	Cantidad a acreditar (BigNumber, decimales del token)	Sí
Hash de transacción	txHash de la operación blockchain o ID de referencia único	Sí
Observación	Motivo/contexto para el registro de auditoría	Recomendado

Efectos en el sistema

• El monto se suma de inmediato al saldo disponible del usuario en el token seleccionado.
• Se registra una entrada de tipo CREDIT en la pestaña Historial → Transacciones.
• El hash queda marcado como procesado — el reenvío con el mismo hash devuelve E00021 (trátelo como éxito, no repita).

Sin reversión automática

Los créditos manuales mueven saldo real. Verifique el token, el monto y el hash antes de confirmar. Para deshacer, será necesario un Débito manual por el mismo monto con referencia al crédito original.

Pantallas relacionadas

• Detalles del usuario — General
• Historial — Transacciones
• Lista de usuarios