Documentação

Español

Português
English

Español

Português
English

Appearance

Depósitos externos (Diario) ​

Requisitos previos de acceso

  • Permiso (módulo): viewExternalDepositsJournal
  • Licencia/Feature: Ninguna
  • Contenedor del menú: GENERAL → grupo Diarios de transacciones → Depósitos externos (/external-deposits-journal)

Qué es / cuándo usar ​

Lista los aportes externos que ingresan a la plataforma — depósitos realizados vía PIX, USDT, BTC, ETH y otros métodos — convirtiendo el valor fiat/cripto en tokens internos acreditados al usuario. El operador lo usa para verificar si un depósito fue pagado y finalizado, identificar depósitos bloqueados (CREATED/PROCESSING) y abrir el detalle para hacer la conciliación entre el valor fiat y el valor en tokens.

Requisitos previos ​

  • Permiso: viewExternalDepositsJournal (permiso doble — enum CPM + módulo dinámico en la BD).
  • Licencia/Feature: ninguna.
  • Dependencias de otras pantallas: Ninguna. Los datos provienen del ExternalBlockchainProvider/servicio de depósitos a través del FMS.

Paso a paso ​

  1. Acceda a Diarios de transacciones → Depósitos externos.
  2. El listado carga paginado desde el servidor.
  3. Busque por ID de usuario (debounce de 400 ms).
  4. Filtre por estado, método de depósito y estado de pago (pagado/no pagado).
  5. Haga clic en visualizar (ojo) para abrir el detalle del depósito.

Filtros y columnas ​

Filtro / ColumnaQué muestra / haceOrigen del dato
Búsqueda por usuarioFiltra los depósitos de un userId. Debounce de 400 ms.Parámetro userId.
EstadoALL, CREATED, FINISHED, PROCESSING, CANCELLED.selectedStatus.
Método de depósitoALL, PIX, USDT, BTC, ETH + métodos descubiertos en los resultados (la lista crece dinámicamente).depositMethod.
Estado de pagoALL, pagado (true), no pagado (false).wasPaid.
Fecha (when)Cuándo se registró el depósito.when.
IdIdentificador del depósito.id.
Usuario (userId)Dueño del depósito.userId.
Valor fiat (fiatAmount)Monto en moneda fiduciaria aportado.fiatAmount (BigNumber).
Valor en tokens (tokensAmount)Tokens internos acreditados por la conversión.tokensAmount (BigNumber).
Método (depositMethod)Canal del depósito (PIX/cripto).depositMethod.
EstadoEstado del depósito.status.
Pagado (wasPaid)Si el pago fue confirmado.wasPaid.
Detalles (acción)Abre el modal de detalle.openDetails(deposit).

Acciones y modales ​

  • Visualizar (ojo): abre ExternalDepositDetailsModalComponent en pantalla completa con los datos completos del depósito (solo lectura).

Reglas de negocio / consideraciones ​

Atención

  • wasPaid = false con estado FINISHED es una inconsistencia a investigar (depósito finalizado pero sin confirmación de pago). Use el detalle y crúcelo con la Sincronización correspondiente.
  • Para métodos en cripto (USDT/BTC/ETH), el valor fiat refleja la conversión en la fecha del aporte; el puente de conversión de moneda (ej.: USD→moneda base) puede introducir una diferencia esperada entre fiat y tokens.
  • Los depósitos bloqueados en CREATED/PROCESSING por mucho tiempo generalmente aguardan confirmación on-chain — revise el diario de Sincronizaciones antes de abrir un ticket.
  • Valores financieros: fiatAmount y tokensAmount son BigNumber — sin redondeo en el origen; la UI formatea a 2 decimales solo para lectura.
  • Idempotencia: la contabilización del depósito es idempotente por externalId; un reprocesamiento que retorne E00021 ("already processed") es éxito (ya acreditado), no un error.

Pantallas relacionadas ​