.jpg)
Diseñar un backend de wallets financieros implica asumir una responsabilidad crítica: garantizar que cada transacción se registre de forma atómica, consistente e inmutable. Ningún error de concurrencia, reintento de red o fallo de infraestructura puede provocar la creación o pérdida de dinero. Este artículo aborda la arquitectura de un núcleo de wallet usando PostgreSQL como fuente de verdad, Node.js para la lógica de transferencia y Kafka para notificar a los servicios periféricos. Se trata de un enfoque que prioriza la integridad financiera mediante contabilidad de doble entrada, bloqueo de filas y claves de idempotencia. El patrón descrito es extrapolable a sistemas de pagos, plataformas de inversión o cualquier aplicación que maneje saldos. En Q2BSTUDIO, como empresa especializada en aplicaciones a medida, aplicamos estos principios en cada proyecto que requiere un manejo fiable de datos sensibles.
La base del diseño reside en un esquema relacional donde el saldo de cada cuenta es un valor calculable a partir de las entradas contables inmutables. Almacenar el dinero en unidades menores enteras (céntimos) evita los errores de redondeo de los tipos flotantes. Cada transferencia se ejecuta dentro de una transacción de base de datos: primero se intenta insertar un registro de transferencia con una clave única de idempotencia; si ya existe, se devuelve el resultado original sin modificar saldos. Luego se bloquean ambas cuentas en orden establecido (ordenando los IDs) para evitar interbloqueos, se verifica que la cuenta origen tenga fondos suficientes, se actualizan los balances y se registran dos entradas contables (débito y crédito). Solo tras confirmar la transacción se emite un evento a Kafka. Este enfoque garantiza que ningún reintento duplique un movimiento y que ningún fallo posterior al commit haga perderse la operación, aunque para una fiabilidad total se recomienda utilizar el patrón de outbox transaccional, donde el evento se persiste en la misma base de datos antes de publicarlo.
La integración con Kafka permite que el resto del sistema reaccione de manera asíncrona: notificaciones, analítica, motores de fraude o ia para empresas pueden consumir los eventos sin ralentizar el flujo principal. Para entornos productivos conviene que los consumidores también sean idempotentes, ya que Kafka garantiza entrega al menos una vez. Además, la conciliación periódica entre el saldo almacenado y la suma de las entradas contables permite detectar cualquier desviación tempranamente. En Q2BSTUDIO integramos servicios cloud aws y azure para desplegar estos sistemas con alta disponibilidad, y aplicamos ciberseguridad en cada capa de comunicación. También desarrollamos agentes IA para automatizar la detección de anomalías y ofrecemos servicios inteligencia de negocio con power bi para visualizar el estado de la cartera en tiempo real. Combinamos inteligencia artificial con software a medida para construir plataformas financieras robustas y escalables, adaptadas a las necesidades específicas de cada cliente.
