Gestionar Pagos Manuales
Requisitos previos de acceso
- Permiso (módulo):
viewPayments(para ver el listado). Las acciones de aprobar/rechazar también requieren los módulosapproveWithdrawalycancelWithdrawalrespectivamente. - Licencia/Feature: Ninguna.
- Contenedor del menú: GENERAL → grupo Operaciones
Qué es / cuándo usar
Pantalla de revisión de los depósitos/aportes manuales realizados por los usuarios — pagos en los que el comprobante se adjunta manualmente (PIX, TED, Neteller) y el sistema no recibe confirmación automática del banco/proveedor. El operador verifica el comprobante (receipt), aprueba — acreditando el saldo del usuario — o rechaza el depósito. Es el punto de conciliación manual entre el dinero ingresado en la cuenta de la casa y el crédito en la billetera del cliente.
Requisitos previos
- Permiso:
viewPaymentspara ver;approveWithdrawal/cancelWithdrawalpara actuar (permiso doble — enum CPM en el backend + módulo dinámico en la DB). - Licencia/Feature: Ninguna.
- Dependencias de otras pantallas: el usuario objetivo debe estar
APPROVED(KYC) para recibir el crédito financiero. Solo es posible actuar sobre depósitos en estado En espera (WAITING).
Paso a paso
- Acceda al menú Operaciones → Gestionar pagos manuales.
- Use la búsqueda (solo números — CPF/CNPJ/identificador) y los dos filtros: tipo de depósito (Todos, PIX, TED, Neteller) y estado (Todos, Aprobado, Cancelado, En espera).
- Haga clic en el ícono de recibo para abrir el comprobante en pantalla completa y verifique el importe y la identidad del remitente.
- Apruebe (ícono check) para acreditar el saldo o rechace (ícono clear) para denegar. Confirme en el pie de pantalla (bottom-sheet).
Filtros y columnas
| Filtro/Columna | Qué muestra | Origen del dato |
|---|---|---|
| Búsqueda | Filtra por documento/identificador (solo números) | Enviado como searchInput al backend (getDeposits) |
| Tipo de depósito | PIX / TED / Neteller / Todos | depositType en la solicitud |
| Estado | En espera / Aprobado / Cancelado / Todos | status en la solicitud |
| Fecha | Fecha y hora del depósito | when |
| Nombre / Identificador | Nombre del usuario y CPF/CNPJ/pasaporte | user (formateado por cpfCnpjFormater) |
| Tipo | Forma de pago | depositType |
| Importe / Moneda | Monto y unidad (token o fiat) | amount / unitOfMoney (BigNumber, 2 decimales) |
| Estado | Estado de la solicitud (verde=aprobado, rojo=cancelado) | status |
| ID Externo | Identificador de la transacción en el proveedor/libro mayor | external_id |
Acciones y modales
- Aprobar (check): abre un bottom-sheet de confirmación; al confirmar, llama a
updateDeposits(id, 'APPROVED'). El backend (FMS – PaymentController) acredita el importe en la billetera del usuario y marca el depósito comoAPPROVED. La página se recarga. - Rechazar (clear): bottom-sheet de confirmación; llama a
updateDeposits(id, 'CANCELLED'). No se genera ningún crédito. - Recibo (receipt): abre el comprobante (
transferProofFile) en pantalla completa. No altera el estado. - Exportar CSV: descarga la página actual en formato
.csv.
Reglas de negocio / consideraciones
Atención
- Los íconos de aprobar/rechazar solo aparecen cuando el estado es En espera (
WAITING). Los depósitos ya aprobados o cancelados son de solo lectura. - Verifique siempre el comprobante y el ID externo antes de aprobar — esta es la conciliación manual; no hay verificación bancaria automática en esta pantalla.
Irreversible
- Aprobar acredita el saldo del usuario de forma inmediata. No hay reversión automática: para revertir la acción, es necesario un asiento financiero de contracargo separado. Trate cada aprobación como una liberación de dinero real.
- Valores financieros: tratados como BigNumber — sin redondeo; verificar los decimales del token/moneda.
- Idempotencia: el crédito en FinLib es idempotente por
externalId. Si el backend retornaE00021"already processed", el depósito ya fue acreditado — trátelo como éxito, no reprocese. - Estado APPROVED: el usuario objetivo debe tener KYC en estado
APPROVEDpara recibir el crédito.