Documentação

Português

English
Español

Português

English
Español

Appearance

Depósitos externos (Jornal) ​

Pré-requisitos de acesso

  • Permissão (módulo): viewExternalDepositsJournal
  • Licença/Feature: Nenhuma
  • Contêiner do menu: GERAL → grupo Jornais de transações → Depósitos externos (/external-deposits-journal)

O que é / quando usar ​

Lista os aportes externos que entram na plataforma — depósitos feitos via PIX, USDT, BTC, ETH e outros métodos — convertendo valor fiat/cripto em tokens internos creditados ao usuário. O operador usa para conferir se um depósito foi pago e finalizado, identificar depósitos travados (CREATED/PROCESSING) e abrir o detalhe para conciliar valor fiat × valor em tokens.

Pré-condições ​

  • Permissão: viewExternalDepositsJournal (permissão dupla — enum CPM + módulo dinâmico no DB).
  • Licença/Feature: nenhuma.
  • Dependências de outras telas: Nenhuma. Os dados vêm do ExternalBlockchainProvider/serviço de depósitos via FMS.

Passo a passo ​

  1. Acesse Jornais de transações → Depósitos externos.
  2. A listagem carrega já paginada do servidor.
  3. Pesquise por ID do usuário (debounce de 400 ms).
  4. Filtre por status, método de depósito e status de pagamento (pago/não pago).
  5. Clique em visualizar (olho) para abrir o detalhe do depósito.

Filtros e colunas ​

Filtro / ColunaO que mostra / fazOrigem do dado
Busca por usuárioFiltra pelos depósitos de um userId. Debounce 400 ms.Parâmetro userId.
StatusALL, CREATED, FINISHED, PROCESSING, CANCELLED.selectedStatus.
Método de depósitoALL, PIX, USDT, BTC, ETH + métodos descobertos nos resultados (a lista cresce dinamicamente).depositMethod.
Status de pagamentoALL, pago (true), não pago (false).wasPaid.
Data (when)Quando o depósito foi registrado.when.
IdIdentificador do depósito.id.
Usuário (userId)Dono do depósito.userId.
Valor fiat (fiatAmount)Valor em moeda fiduciária aportado.fiatAmount (BigNumber).
Valor em tokens (tokensAmount)Tokens internos creditados pela conversão.tokensAmount (BigNumber).
Método (depositMethod)Canal do depósito (PIX/cripto).depositMethod.
StatusEstado do depósito.status.
Pago (wasPaid)Se o pagamento foi confirmado.wasPaid.
Detalhes (ação)Abre o modal de detalhe.openDetails(deposit).

Ações e modais ​

  • Visualizar (olho): abre ExternalDepositDetailsModalComponent em tela cheia com os dados completos do depósito (somente leitura).

Regras de negócio / cuidados ​

Atenção

  • wasPaid = false com status FINISHED é uma inconsistência a investigar (depósito concluído mas sem confirmação de pagamento). Use o detalhe e cruze com o Sincronismo correspondente.
  • Para métodos em cripto (USDT/BTC/ETH), o valor fiat reflete a conversão na data do aporte; a ponte de conversão de moeda (ex.: USD→moeda base) pode introduzir diferença esperada entre fiat e tokens.
  • Depósitos travados em CREATED/PROCESSING por muito tempo geralmente aguardam confirmação on-chain — confira o jornal de Sincronismos antes de abrir chamado.
  • Valores financeiros: fiatAmount e tokensAmount são BigNumber — sem arredondamento na origem; a UI formata em 2 casas só para leitura.
  • Idempotência: a contabilização do depósito é idempotente por externalId; um reprocessamento que retorne E00021 ("already processed") é sucesso (já creditado), não erro.

Telas relacionadas ​