Gerenciar Pagamentos Manuais
Pré-requisitos de acesso
- Permissão (módulo):
viewPayments(para ver a listagem). As ações de aprovar/recusar exigem ainda os módulosapproveWithdrawalecancelWithdrawalrespectivamente. - Licença/Feature: Nenhuma.
- Contêiner do menu: GERAL → grupo Operações
O que é / quando usar
Tela de revisão dos depósitos/aportes manuais feitos pelos usuários — pagamentos em que o comprovante é anexado manualmente (PIX, TED, Neteller) e o sistema não recebe confirmação automática do banco/provedor. O operador confere o comprovante (receipt), aprova — creditando o saldo do usuário — ou recusa o depósito. É o ponto de conciliação manual entre o dinheiro que entrou na conta da casa e o crédito na carteira do cliente.
Pré-condições
- Permissão:
viewPaymentspara ver;approveWithdrawal/cancelWithdrawalpara agir (permissão dupla — enum CPM no backend + módulo dinâmico no DB). - Licença/Feature: Nenhuma.
- Dependências de outras telas: o usuário-alvo precisa estar
APPROVED(KYC) para receber crédito financeiro. Só é possível agir sobre depósitos em Aguardando (WAITING).
Passo a passo
- Acesse o menu Operações → Gerenciar pagamentos manuais.
- Use a busca (apenas números — CPF/CNPJ/identificador) e os dois filtros: tipo de depósito (Todos, PIX, TED, Neteller) e status (Todos, Aprovado, Cancelado, Aguardando).
- Clique no ícone recibo para abrir o comprovante em tela cheia e confira o valor e a identidade do remetente.
- Aprove (ícone check) para creditar o saldo ou recuse (ícone clear) para negar. Confirme no rodapé (bottom-sheet).
Filtros e colunas
| Filtro/Coluna | O que mostra | Origem do dado |
|---|---|---|
| Busca | Filtra por documento/identificador (somente números) | Enviado como searchInput ao backend (getDeposits) |
| Tipo de depósito | PIX / TED / Neteller / Todos | depositType na requisição |
| Status | Aguardando / Aprovado / Cancelado / Todos | status na requisição |
| Data | Data e hora do depósito | when |
| Nome / Identificador | Nome do usuário e CPF/CNPJ/passaporte | user (formatado por cpfCnpjFormater) |
| Tipo | Forma do pagamento | depositType |
| Valor / Moeda | Montante e unidade (token ou fiat) | amount / unitOfMoney (BigNumber, 2 casas) |
| Status | Estado da solicitação (verde=aprovado, vermelho=cancelado) | status |
| ID Externo | Identificador da transação no provedor/ledger | external_id |
Ações e modais
- Aprovar (check): abre bottom-sheet de confirmação; ao confirmar, chama
updateDeposits(id, 'APPROVED'). O backend (FMS – PaymentController) credita o valor na carteira do usuário e marca o depósito comoAPPROVED. A página recarrega. - Recusar (clear): bottom-sheet de confirmação; chama
updateDeposits(id, 'CANCELLED'). Nenhum crédito é gerado. - Recibo (receipt): abre o comprovante (
transferProofFile) em tela cheia. Não altera estado. - Exportar CSV: baixa a página atual em
.csv.
Regras de negócio / cuidados
Atenção
- Os ícones de aprovar/recusar só aparecem quando o status é Aguardando (
WAITING). Depósitos já aprovados ou cancelados são somente leitura. - Sempre confira o comprovante e o ID externo antes de aprovar — esta é a conciliação manual; não há checagem bancária automática nesta tela.
Irreversível
- Aprovar credita o saldo do usuário imediatamente. Não há rollback automático: para reverter, é necessário um lançamento financeiro de estorno separado. Trate cada aprovação como liberação de dinheiro real.
- Valores financeiros: tratados como BigNumber — sem arredondamento; conferir as casas decimais do token/moeda.
- Idempotência: o crédito no FinLib é idempotente por
externalId. Se o backend retornarE00021"already processed", o depósito já foi creditado — trate como sucesso, não reprocesse. - Status APPROVED: o usuário-alvo deve estar com KYC
APPROVEDpara receber o crédito.