Wallets y transacciones¶
Modelo¶
- Cada usuario tiene una wallet por moneda.
Walletincluyecurrency_iso,balance,defaultyblocked.Transactionregistra 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
balancedirectamente. - Emitir
TransactionPerformeddespué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.sendcontrola el envío.
Ver Alertas.
Sincronización de saldo¶
- El BackOffice publica actualizaciones en SQS (
vortex-play-balance-updates.fifo). balance-websocketlas consume y notifica al front.- El header del BackOffice se actualiza con
HeaderBalance.
Consultas¶
TransactionResourceyTransactionsRelationManagerson 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 |