Saltar a contenido

Wallets y transacciones

Modelo

  • Cada usuario tiene una wallet por moneda.
  • Wallet incluye currency_iso, balance, default y blocked.
  • Transaction registra créditos y débitos con tipo, proveedor y referencia.
  • Los movimientos se hacen siempre con Platform\Utils\Wallets (credit() / debit()).

Operaciones

Operación Entrada
Depósito PerformTransactionAction, PerformTransactionsAction
Retiro PerformTransactionAction, PerformTransactionsAction
Ajuste manual ManualBalanceAdjustmentAction

Reglas:

  • Verificar el código de respuesta (ResponseCodes::OK).
  • El agente que opera ajusta su propia wallet cuando corresponde.
  • Respetar bloqueos de saldo y proveedores.
  • No modificar balance directamente.
  • Emitir TransactionPerformed después del commit.

Umbrales y alertas

  • Las alertas se envían si el monto supera el umbral de la moneda.
  • Umbrales en configurations.data.alerts.transactions.
  • Una moneda sin umbral no genera alerta.
  • El permiso alerts.send controla el envío.

Ver Alertas.

Sincronización de saldo

  • El BackOffice publica actualizaciones en SQS (vortex-play-balance-updates.fifo).
  • balance-websocket las consume y notifica al front.
  • El header del BackOffice se actualiza con HeaderBalance.

Consultas

  • TransactionResource y TransactionsRelationManager son de solo lectura.
  • Los reportes de caja y ajustes usan Athena.
  • Filtrar siempre por plataforma, moneda y red de agentes.

Errores comunes

Síntoma Causa probable
Saldo no cambia No se usó Wallets o falló el código de respuesta
Alerta no llega Umbral no configurado o falta alerts.send
Saldo en otra moneda Se ignoró session('currency')
Movimiento duplicado No se validó el ticket o la transacción original