§Resumen y alcance

Tipre · PrepagaCorporate · Propuesta · v8

Tarjeta PrepagaCorporate

Propuesta de evolución del sistema de tarjetas giftcard / prepagas hacia un nuevo producto con Spring Boot, app web (Flutter/React) y pago por QR en PWA.

Base actual: TiPrepagaComprasBackOffice Stack actual: Seam 2 · JBoss 4.2.2 · SQL Server Fecha: 09/11/2026 Tipo: Propuesta Revisión: v8 · 16/11/2026 · ver Anexo A

Vista general del sistema

PrepagaCorporate / Prepagas y giftcards con QR El saldo se carga una vez, vive en la plataforma y se consume en caja con el celular. 1 Carga del saldo Una empresa compra un cupo para sus empleados, o una persona compra una giftcard. El saldo queda en una cuenta, no en un plástico. Una cuenta por tarjeta reclama muestra QR valida 2 Consumo en caja El titular muestra su QR dinámico y marca su PIN. La caja consulta a la plataforma y debita en línea. QR + PIN en toda compra 3 resultados de cada consumo Débito del saldo Nota de crédito Clearing inter-socios Registrados en la misma operación Portal de empresas Giftcard en caja Carga masiva El saldo no viaja. El QR es solo la llave: cambia cada 30 segundos. Sin plástico La tarjeta es una cuenta: se entrega por enlace y se usa desde el celular. Difícil de copiar El QR cambia cada 30 segundos y cada compra pide PIN. Multicomercio Se carga en un socio y se gasta en otro; el clearing compensa. Fiscal integrado Factura del acuerdo y notas de crédito desde el mismo sistema. Idempotencia Un reintento no duplica la operación. Validación en línea La caja siempre consulta a la plataforma. Recuperación Contacto verificado para PIN olvidado. Auditoría Toda operación queda registrada. Convivencia Las tarjetas de banda siguen operando.
Recorrido del saldo: se carga una vez, el titular lo reclama y lo consume en caja con QR y PIN. El mapa completo de la plataforma está en §2.

Parte 1

Propuesta — Tarjeta PrepagaCorporate como producto

Reescritura sobre tecnologías actuales (Spring Boot + app web + PWA), migración de banda a QR con hash, y autogestión para empresas y personas.

01

Visión y objetivos del producto

Convertir el sistema interno actual en un producto comercializable —"Tarjeta PrepagaCorporate"— que una empresa pueda contratar para dar beneficios a sus empleados, y que una persona pueda adquirir como giftcard, usando el celular como medio de pago en el POS en lugar de un plástico con banda.

i
Alcance de este documento. Contiene solo la propuesta. El relevamiento del sistema vigente se mantiene por separado, en la Parte 1 de la versión 4; las referencias del tipo «§6 del estado actual» remiten a ese documento.

Objetivos

  • Eliminar el plástico con banda: reemplazar la tarjeta física por un QR con hash aleatorio que el titular presenta desde su celular.
  • Autogestión del titular: una PWA con login único —por ejemplo leyendo el PDF417/QR del DNI, con lo que además queda registrado— que luego queda disponible para próximos usos y administra su cuenta, saldo y movimientos.
  • Portal de empresas: gestión ágil de acuerdos, alta de empleados, asignación de tarjetas y recargas, conservando la importación y asignación masiva de saldos (como las operaciones actuales) pero sin el límite del CSV y con carga de alto volumen mediante bulk insert.
  • Venta directa de giftcard: onboarding autogestionado para quien compra una tarjeta de regalo sin pasar por una empresa.
  • Beneficios y descuentos: aplicar un beneficio/% configurable por empresa, por lote/acuerdo y también al momento del pago en el POS.
  • Facturación del acuerdo desde el sistema: poder emitir la factura de venta del acuerdo desde el propio sistema —al cargarlo o en una fecha configurable posterior a las transacciones— en lugar de depender del ERP.
  • Multicomercio / multi-razón social: soportar varias razones sociales de supermercado (p. ej. una cooperativa con varias) y acuerdos de empresa exclusivos con ellas, con la opción de una tarjeta usable en más de una razón social.
  • Fidelización opcional: permitir que el titular cargue sus datos para nominar y fidelizar su cuenta si lo desea, sin bloquear el uso básico.
  • Conservar el circuito fiscal vigente y completarlo: reutilizar el flujo de NC B con CAE ya en producción; la Factura A / NC A, el prorrateo y las percepciones son desarrollo nuevo (ver §7 del estado actual y §9).
02

Arquitectura objetivo

PrepagaCorporate / Prepagas y giftcards con QR Una sola cuenta por tarjeta: quien carga y quien consume operan sobre el mismo saldo. PrepagaCorporate Plataforma de cuenta y saldo Valida, debita y registra cada operación en línea. 1 Portal de empresas Acuerdos, padrón de empleados, cargas y recargas masivas. 2 App web del titular Reclamo, PIN, QR dinámico, saldo y movimientos, sin instalar nada. 3 POS del supermercado Venta de giftcard, pago con QR y PIN, anulación y reverso. 4 Razones sociales adheridas Cada supermercado o cooperativa emite y acepta tarjetas. 5 Backoffice Alta de socios, parámetros, soporte y seguimiento. 1 Cuenta y saldo Un único saldo por tarjeta, con débito atómico y sin duplicados. 2 QR dinámico y PIN Código de un solo uso cada 30 segundos y PIN en toda compra. 3 Facturación y notas de crédito Factura del acuerdo y nota de crédito por cada consumo. 4 Clearing inter-socios Compensa los consumos cruzados y liquida la posición neta. 5 Reportes y beneficios Consumo por empresa y período; descuentos configurables.
Mapa de la plataforma: quién la opera (izquierda) y qué resuelve (derecha). La vista técnica de componentes sigue debajo.

Backend en Spring Boot exponiendo una API REST (más eventos para facturación), y dos frontends web construidos con la misma base (Flutter web o React): un portal de empresas/backoffice y una PWA del titular. El POS integra por API/QR. La lógica fiscal se mantiene como servicio dedicado contra TiFacturaOnline.

PWA TitularFlutter/React · QR Portal Empresaacuerdos · recargas POS / cajalee QR API GatewayPrepagaCorporateREST · JWT Backend Spring Boot (microservicios / módulos) Auth / Identidad (login único) Tarjetas · QR/token · saldos Transacciones (compra/recarga) Empresas · acuerdos · beneficios Facturación acuerdo + NC (REST) eventos / cola de facturación DBSQL/PostgreSQL TiFacturaNextREST · AFIP
Arquitectura objetivo. API REST con JWT como puerta única; backend Spring Boot modular; PWA y portal construidos sobre la misma base; facturación desacoplada por eventos contra TiFacturaOnline. El POS consume la API leyendo el QR del titular.
CapaTecnología propuestaRol
BackendSpring Boot (REST + seguridad + JPA)Dominio, saldos, tokens de tarjeta, facturación por eventos
PWA titularFlutter web o React (instalable; consulta en caché sin conexión, pago siempre en línea)Login único, QR de pago, saldo y movimientos
Portal empresa / backofficeFlutter web o ReactAcuerdos, empleados, asignación y recargas, reportes
DatosSQL Server o migración a PostgreSQLPersistencia; esquema evolucionado del actual
FiscalServicio dedicado + TiFacturaOnlineReutiliza el circuito de NC B vigente; Factura A, prorrateo y percepciones se desarrollan nuevos
▸
Multicomercio desde el diseño. El modelo debe ser multi-razón social: cada supermercado/cooperativa es una razón social emisora, las empresas firman acuerdos exclusivos con una o varias, y el backend resuelve en cada pago contra qué razón social se debita (ver §5).
▸
Decisión abierta: Flutter vs React. Flutter permite una base única que compila a web y a app móvil nativa (útil si más adelante se quiere app de tienda); React es más estándar para web y más fácil de contratar. La PWA cubre el requisito de "usar desde el celular sin instalar de una tienda" en ambos casos.
03

De banda magnética a QR + hash

El cambio central: la tarjeta deja de ser un PAN en una banda y pasa a ser una cuenta identificada por un token/hash aleatorio, que el titular presenta como QR desde la PWA. El saldo sigue viviendo en el backend; el QR es solo la llave de acceso a esa cuenta, nunca el saldo.

Cuenta / tarjetasaldo en backend Token = hash aleatorioopaco · revocable · único QR en PWAestático o dinámico POS escaneavalida contra API El QR nunca contiene el saldo: solo referencia la cuenta. El backend es la única fuente de verdad.
El token es un hash aleatorio y opaco asociado a la cuenta, no derivable del número de tarjeta. Se puede revocar y reemitir (robo/pérdida) sin reimprimir nada, y admite QR estático (ligado a la cuenta) o dinámico de un solo uso (mayor seguridad).

QR dinámico: generación y validación

El QR de pago cambia cada pocos segundos y solo sirve el más reciente. Se construye con un código de un solo uso basado en tiempo (TOTP): la aplicación y el backend comparten un secreto por tarjeta y calculan el mismo código para cada intervalo. El QR nunca contiene el saldo ni el secreto.

ElementoDefinición
Contenido del QRPC1.{idToken}.{timestamp}.{código}: versión del formato, identificador opaco de la tarjeta, hora de generación y código del intervalo
SecretoÚnico por tarjeta, aleatorio, emitido al reclamar o enrolar y guardado en la aplicación del titular. Se reemplaza en toda reemisión o recuperación
Intervalo30 segundos
ToleranciaUn intervalo hacia atrás y uno hacia adelante, para absorber el desfase de reloj del teléfono
Un solo usoEl backend registra el par tarjeta + intervalo ya utilizado y rechaza un segundo intento
App web POS API Cuenta / DB 1 · genera un QR nuevo cada 30 s 2 · muestra el QR vigente 3 · POST /pagos {qr, PIN, importe, idTrx} 4 · ventana · código · sin reuso 5 · PIN, estado y saldo · debita 6 · aprobada + nuevo saldo alt · QR vencido o ya usado
La aplicación renueva el QR sola. La caja lo envía junto con el PIN; el backend comprueba la ventana de tiempo, recalcula el código y verifica que ese intervalo no se haya usado, antes de validar PIN, estado y saldo.
  1. Separar los campos del QR y buscar el secreto por idToken.
  2. Rechazar si la hora del QR queda fuera de la ventana respecto de la hora del servidor.
  3. Recalcular el código con el secreto y compararlo en tiempo constante.
  4. Registrar el intervalo como usado para esa tarjeta; si ya lo estaba, rechazar.
  5. Recién entonces validar PIN, estado y saldo, y debitar (§4).
SituaciónResultado
Captura de pantalla o foto usada más tardeRechazada: el intervalo venció
QR impreso o reenviadoRechazado: el intervalo venció
Mismo QR presentado dos vecesRechazado: el intervalo ya fue usado
Foto usada por un tercero dentro de los mismos 30 segundosNo lo impide el QR; lo impide el PIN, obligatorio en toda compra de giftcard (§6)
Caja sin conexión con el backendNo se puede pagar: la validación es siempre en línea
▸
Decisión tomada (16/11/2026): el código se calcula en el teléfono. El secreto se guarda en la aplicación del titular, de modo que el QR se muestra aunque el teléfono no tenga señal dentro del local; la validación sigue siendo siempre en línea, del lado de la caja. Se descartó calcularlo en el backend porque exigiría conexión del teléfono en el momento de pagar. Consecuencias: el secreto se entrega una sola vez, al reclamar o enrolar, por un canal cifrado; toda reemisión o recuperación lo reemplaza; y, como no está ligado al hardware del teléfono, el esquema impide la copia en la práctica y no de forma absoluta. El PIN y el control de un solo uso acotan ese riesgo.

Enrolamiento y login único

  1. El titular recibe un enlace/QR de activación único —para imprimir o enviar por mail o WhatsApp— cuando la empresa le asigna la tarjeta o al comprar la giftcard, y desde ahí inicia el registro.
  2. Abre la PWA, verifica su identidad (por ejemplo leyendo el PDF417/QR del DNI, que a la vez lo registra) y se loguea una sola vez; la sesión queda persistida en el dispositivo (token de refresco seguro).
  3. La cuenta queda disponible para próximos usos sin volver a loguearse, con acceso a saldo, movimientos y su QR de pago.
  4. Ante pérdida del dispositivo, el titular revoca el token y reemite el QR desde otro acceso, sin cambiar de "tarjeta".
!
Puntos a resolver antes de implementar. (1) Un QR estático es una credencial al portador: una captura de pantalla lo duplica igual que una banda clonada; se recomienda QR dinámico de vida corta como único modo de pago. (2) La lectura del PDF417 del DNI identifica pero no autentica: quien tenga una foto del documento podría enrolarse; hace falta un segundo factor (p. ej. OTP al contacto informado por la empresa). (3) La recuperación "desde otro acceso" requiere una credencial o canal verificado que hoy no está definido. (4) El enlace de activación también es al portador: debe ser de un solo uso y con vencimiento. Ver §9. Para la giftcard estos puntos ya están resueltos en §6: PIN y contacto verificado son obligatorios, y el DNI sigue siendo opcional.
▸
Fidelización opcional. El enrolamiento con datos del titular (nombre, DNI, contacto y, si corresponde, PIN) es opt-in: sirve para nominar la cuenta y acceder a beneficios/fidelización, pero no es obligatorio para usar la tarjeta. Esto reemplaza los controles hoy parametrizables (embozado/DNI/PIN, §4 del estado actual) por una elección del propio titular.
▸
Compatibilidad. El modelo permite una etapa de convivencia: el backend puede aceptar tanto el PAN de banda de tarjetas ya emitidas como el nuevo token QR, de modo que la migración sea gradual y no obligue a reemitir todo el parque de una vez.
04

Pago en POS con QR y PWA

En caja, el titular abre su QR en la PWA y la caja lo escanea; el backend valida el token, el estado y el saldo, debita y responde. Es el mismo flujo lógico que la compra actual, pero sobre API REST y con el QR como identificador.

PWA Titular POS API Spring Boot Cuenta/DB 1 · muestra QR (token) 2 · POST /pagos {token, PIN, importe, caja, idTrx} 3 · valida QR, PIN y saldo · debita 4 · aprobada + nuevo saldo 5 · push a la PWA: movimiento + saldo actualizado alt · token inválido/revocado · saldo insuficiente
Pago con QR. El token viaja del QR al POS y de ahí a la API; el backend valida y debita de forma atómica, devuelve el nuevo saldo a la caja y notifica a la PWA del titular el movimiento. Las ramas de error (rojo punteado) replican las validaciones actuales.

Anulación y reverso se mantienen como operaciones de la API, localizando la transacción original por los mismos datos de caja (sucursal + POS + ticket) o por un identificador único de transacción, preservando la tolerancia a reintentos del POS.

!
Requisitos que el flujo actual no cumple. El débito atómico y la idempotencia de la compra son requisitos nuevos, no comportamiento heredado (§6 del estado actual): cada pago debe llevar una clave de idempotencia (idTrx) con restricción de unicidad en la base, y el débito debe resolverse con una actualización condicional o bloqueo sobre la cuenta. Además, cada caja debe autenticarse ante la API con credenciales propias (por dispositivo o sucursal); el servicio actual no autentica al llamador.
▸
Identificación online. A diferencia del esquema actual (BIN local en dM_Banda), el nuevo flujo valida el token/hash online contra el backend en cada pago; eso habilita revocación inmediata, QR dinámico de un solo uso y uso multi-razón social.
▸
Beneficio al momento del pago. La API puede aplicar en cada compra un beneficio/% configurable por empresa (y por razón social): ajusta el importe debitado —o acredita un reintegro— y lo deja registrado en la transacción y en el comprobante, sin cambiar la experiencia en caja.
request notificación / respuesta rama de error
05

Empresas, acuerdos, beneficios y multicomercio

El portal de empresas reemplaza la carga CSV y las pantallas JSF por un flujo autogestionado. La empresa administra sus acuerdos, su padrón de empleados y las recargas, con reportes de uso.

Alta empresay acuerdo Padrón empleadosalta / importación Asigna tarjetaemite QR + invita Recargapuntual / masiva Reportes + facturauso · saldos
Ciclo de la empresa en el portal. El acuerdo actual (ClienteAcuerdo/AcuerdoTarjeta) se conserva como modelo de fondo, pero la operación pasa a ser self-service, con emisión de QR e invitación automática al empleado.
  • Acuerdos: la empresa crea y renueva acuerdos (cupo, vigencia, condiciones de facturación) sin intervención del backoffice.
  • Empleados: alta individual o importación masiva (sin el límite de 2 MB del esquema actual, con bulk insert para alto volumen); cada empleado recibe su invitación para enrolar la PWA.
  • Recargas: puntuales o masivas (p. ej. carga mensual) con asignación de saldos en lote vía bulk insert, sobre la lógica de recarga existente (asignado += importe).
  • Reportes: consumo por empleado/período, saldos vigentes y comprobantes emitidos.

Beneficios y descuentos

El sistema permite definir un beneficio/% en tres niveles: por empresa (condición general del acuerdo), por lote/recarga (una promo puntual imputada a toda una carga) y al momento del pago en el POS (§4). Acumulables o excluyentes según configuración.

Facturación del acuerdo y notas de crédito

Al constituir el acuerdo, el sistema emite una factura nominada a la empresa por el monto del acuerdo (previa), opcionalmente con un beneficio/% imputado a todo el lote; también puede diferirse a una fecha configurable si se prefiere facturar según el consumo. Luego, a medida que se registran consumos en el POS, un proceso periódico y automático emite las notas de crédito mediante el nuevo método API REST del servicio TiFacturaOnlineNext, localizando el comprobante de venta original por nº de ticket + nº de POS + nº de sucursal (el comprobante puede ser CAE o CAEA).

!
A definir. Un beneficio aplicado al momento del pago modifica la base sobre la que se calcula la NC; la facturación diferida "según consumo" y la NC por consumo necesitan una regla de conciliación para no devolver IVA dos veces; y el uso de CAEA requiere reglas propias de informe y contingencia. Ninguno de estos casos existe en el circuito actual (§7 del estado actual).

Multicomercio y multi-razón social

El producto soporta múltiples razones sociales de supermercado: por ejemplo una cooperativa como Almacor, que agrupa varias razones sociales, o distintas cadenas. Cada empresa define acuerdos exclusivos con una o más de ellas, y la misma plataforma puede atender clientes de cadenas distintas. Está definido que —como en las tarjetas multimarca del mercado (§7)— una tarjeta cargada en una razón social puede usarse en más de una razón social; el backend resuelve en cada pago contra qué entidad se debita y factura.

06

Venta directa de giftcard (sin empresa)

El canal de venta directa (hoy resuelto por la operación venta contra el cliente "GiftCard") se moderniza como un onboarding autogestionado: la persona compra la giftcard —en caja, web o e-commerce— y la activa en la PWA sin necesidad de un acuerdo de empresa.

  1. Compra: la persona adquiere la giftcard por un monto; el backend crea la cuenta y emite el token (equivalente a la venta actual).
  2. Entrega: recibe un QR/enlace de activación (para sí o para regalar).
  3. Reclamo: quien la recibe abre el enlace, verifica un teléfono o mail con un código, elige su PIN y la cuenta queda lista; a partir de ese momento el enlace deja de ser válido.
  4. Uso y recarga: paga en POS con su QR y su PIN; según reglas de producto, puede recargarse o quedar como saldo de un solo uso.

Esquema de seguridad de la giftcard

La giftcard es al portador y se regala, por lo que la seguridad no puede apoyarse en la identidad del titular. El QR se asume copiable; el esquema está diseñado para que copiarlo no alcance para gastar el saldo.

ControlReglaQué evita
Reclamo únicoEl enlace o QR de entrega es un vale para reclamar la tarjeta, no la tarjeta. El primer reclamo emite un token nuevo e invalida el enlaceQue quien la compró o la reenvió pueda gastarla después de regalarla
PIN siempreEl titular elige un PIN al reclamar y la caja lo exige en toda compra, sin umbral de importe. Se almacena con hash y salt, con bloqueo tras 3 a 5 intentos fallidosEl uso de un QR copiado (captura de pantalla, foto)
Contacto verificado obligatorioAl reclamar se verifica un teléfono o mail con un código de un solo uso. El DNI sigue siendo opcional y solo para fidelizaciónLa pérdida del saldo por PIN olvidado o pase eliminado
Token aleatorioIdentificador largo y no secuencial, con límite de intentos por caja y por IPLa adivinación de tarjetas por prueba
Saldo tras el pagoLa cuenta se acredita solo cuando el pago está confirmadoEl uso de tarjetas no vendidas
Aviso y bloqueoCada consumo se notifica al titular, que puede bloquear la tarjeta por su cuentaEl consumo no autorizado sostenido
Consulta de saldo protegidaRequiere token y PIN, o tiene límite de intentosLa exposición del saldo con solo conocer el identificador
TopesSaldo máximo por tarjeta e importe máximo diarioAcota la pérdida ante cualquier fraude

Alternativa evaluada: pase de Google Wallet / Apple Wallet

i
Revisado y descartado por ahora (11/11/2026). Se evaluó ofrecer la giftcard como pase de billetera, agregado al teléfono al escanear un QR o abrir un enlace. Se descarta en esta etapa porque agrega complejidad sin reemplazar nada: el pase no es interactivo, de modo que el reclamo, el PIN, el contacto, el bloqueo y los movimientos requieren igualmente la aplicación web; exige dos integraciones distintas, con cuenta de emisor en Google y certificados de Apple; el código es fijo en Apple y la actualización del saldo en el pase no está garantizada; y crea dependencia de las políticas de ambos proveedores. La presentación de la tarjeta queda a cargo de la aplicación web. NFC también queda descartado. El tema puede reabrirse una vez que la base web esté en producción. Revisión del 16/11/2026: según la documentación de Google Wallet y el foro de desarrolladores de Apple, Google ofrece código rotativo para pases de giftcard y Apple no tiene equivalente (no verificado con un pase de prueba). El descarte se mantiene, porque los teléfonos de Apple requerirían de todos modos el QR dinámico de la aplicación web (§3).

Recuperación y reemisión

  • Antes del reclamo: el comprador puede pedir la reemisión del enlace presentando el comprobante de compra; el enlace anterior se invalida.
  • Después del reclamo: solo el titular, mediante un código enviado a su contacto verificado, puede elegir un PIN nuevo o reemitir la tarjeta. El comprobante de compra deja de habilitar cualquier gestión, para que el comprador no pueda recuperar una tarjeta ya regalada.
  • Toda reemisión rota el token, conserva el saldo y queda registrada.
!
A validar con legales. El tratamiento del contacto del titular como dato personal y las condiciones de vencimiento o pérdida del saldo.
▸
Reglas de producto a definir. Ya está definido que la giftcard es al portador, con PIN y contacto verificado obligatorios. Quedan por fijar: vigencia del saldo, si admite recarga y si puede transferirse después del reclamo. Hoy en el mercado conviven ambos modelos (ver sección 7); el nuevo producto puede soportar los dos por configuración de acuerdo.
07

Análisis competitivo

El mercado de giftcards en Argentina se estimó en torno a US$1.190 millones para 2025, con un crecimiento anual cercano al 12% (cifras sin fuente citada: agregar la referencia antes de circular el documento) y una fuerte tracción del canal corporativo y del e-gifting, además de una integración creciente de las giftcards en billeteras digitales. Es un contexto favorable para un producto que combine uso corporativo y digitalización del medio de pago.

ReferenteModeloQué tomar como referencia
Cencosud GiftCardRetail: tarjeta prepaga emitida por el supermercado (administrada por First Data) y adquirida por empresas para entregar a usuarios finales; usable en sus cadenas (Jumbo, Disco, Vea, Easy)Modelo B2B2C maduro; distinción al portador vs nominada; límite de tarjetas por compra
Oh! Gift Card / GifyFintech (Gift Card Argentina S.A.) de pagos closed-loop y "moneda de marca"; plataforma omnicanal que emite y administra gift cards digitales de marcas de retail, moda, supermercados y delivery. Gify es su tienda/marca comercial multicomercio: se elige marca y monto y se recibe la gift card por WhatsApp/emailModelo white-label para que un retailer lance su propio programa; catálogo multimarca; redención presentando la tarjeta desde el celular en caja
Ualá / NubiFintech: prepagas que las empresas dan a empleados, integradas a billetera móvilExperiencia 100% digital y autogestión desde el celular; rubros fuertes: supermercado y almuerzo
Pluxee / EdenredBeneficios corporativos: tarjetas de regalo/beneficios para empleados con portal de gestiónPropuesta de valor corporativa (reconocimiento, deducibilidad) y portal de administración para RR.HH.
GivexPlataforma global de giftcard + fidelización + POS; recarga automática de grupos de tarjetas; redención por QR/códigoPlataforma unificada, "top-up" programado de cupos, y digitalización de giftcards a wallet móvil
Mercado LibreEcosistema dominante de e-commerce y billetera (prepaga Mastercard, Mercado Puntos); gifting digital como "Ticket de Regalo" para intercambiar un obsequio sin involucrar al compradorGifting integrado al checkout y a la app; escala y hábito de compra digital ya instalados
PedidosYaGift card digital de la plataforma de delivery, canjeable en la app/web vía "Mis cupones" (de un solo uso, consume todo el saldo)Closed-loop 100% in-app; canje por código, sin plástico ni POS
Shoppings y sus marcasCentros comerciales (p. ej. del grupo IRSA) y sus locales emiten gift cards digitales por marca —en buena parte sobre la plataforma de Oh!/Gify— redimibles en los locales adheridosGift card por marca presentada desde el celular en caja; vigencia típica de 180 días; oportunidad de un producto multimarca de centro comercial

Patrón técnico dominante (validación del enfoque QR)

Las soluciones digitales actuales (Givex con redención por QR, wallets tipo PassKit/Apple-Google Wallet, Aldelo, y PWAs de giftcard sobre POS de terceros) comparten el mismo patrón que proponemos: el QR o pase es solo una interfaz/llave; el saldo vive en la base del emisor; el POS escanea, consulta el backend, procesa y actualiza el saldo. Varias de estas soluciones usan explícitamente una PWA instalable sin tienda de apps y onboarding por QR + teléfono, exactamente el modelo de esta propuesta.

En Argentina ese patrón ya es norma: Oh!/Gify, PedidosYa y las marcas de shopping entregan gift cards digitales que se presentan desde el celular en caja (closed-loop por marca, vigencia típica de 180 días). La propuesta se diferencia al sumar, sobre ese mismo gesto, la recarga, el uso corporativo (acuerdos y beneficios a empleados) y una cuenta persistente con saldo y movimientos.

i
Diferenciador posible: unir en un solo producto el uso corporativo (acuerdos, recargas, beneficios a empleados), la venta directa como giftcard y el pago por QR en PWA sin emisión de plástico, apoyado en un circuito de NC con CAE ya en producción (hoy solo tipo B; ver §7 del estado actual).
08

Roadmap de implementación

Propuesta de fases para evolucionar sin interrumpir la operación actual.

FaseFocoEntregable
0 · BaseModelo de dominio y APIBackend Spring Boot con tarjetas, saldos, transacciones y auth; esquema de datos evolucionado
1 · QR + PWAToken/hash y PWA del titularEmisión de token, QR de pago, login único, saldo y movimientos; convivencia con banda
2 · POSIntegración de caja por API/QRCompra, anulación y reverso por API leyendo QR; piloto en sucursales
3 · FiscalFacturación desacopladaFactura del acuerdo nominada a la empresa + NC por consumos vía API REST de TiFacturaOnlineNext (busca el comprobante por ticket/POS/sucursal; CAE o CAEA)
4 · EmpresasPortal de autogestiónAcuerdos, padrón de empleados, recargas masivas y reportes
5 · Venta directaGiftcard sin empresaOnboarding autogestionado, compra web/e-commerce, reglas de vigencia/recarga; esquema de seguridad de la giftcard (§6)
6 · BeneficiosDescuentos configurablesBeneficio/% por empresa, por lote y al momento del pago en POS
7 · MulticomercioMulti-razón socialRazones sociales emisoras, acuerdos exclusivos empresa↔razón social y tarjeta usable en más de una
▸
Estrategia de convivencia. Mantener el backoffice actual operativo mientras el nuevo backend asume primero los canales digitales (QR/PWA), y migrar progresivamente POS, facturación y empresas. Las tarjetas de banda ya emitidas se siguen aceptando hasta su vencimiento natural.
!
Observaciones sobre el orden. (1) Durante la convivencia debe existir un único dueño del saldo: dos backends escribiendo la misma cuenta reproducen el problema de concurrencia de §6 del estado actual. (2) El piloto en POS (fase 2) precede a la fase fiscal (3), de modo que operaría sin NC; conviene adelantar lo fiscal o acotar el piloto a clientes sin NC. (3) El modelo multi-razón social se declara "desde el diseño" (§2) pero figura en la fase 7: al menos el modelo de datos debe entrar en la fase 0.
09

Riesgos y decisiones abiertas

Resultado de contrastar el relevamiento del estado actual con el código de TiPrepagaComprasBackOffice y de revisar la propuesta. Cada punto requiere una decisión antes de pasar a diseño detallado.

TemaSituaciónDecisión requerida
Alcance fiscalHoy solo se emite NC B por importe total, con IVA fijo del 21%Definir si Factura A / NC A, prorrateo, percepciones y CAEA entran en el alcance, y estimarlos como desarrollo nuevo
Débito e idempotenciaEl débito actual no es atómico y la compra no es idempotenteClave de idempotencia obligatoria, unicidad en base y estrategia de bloqueo sobre la cuenta
Tipo de QRQR dinámico de un solo uso, renovado cada 30 segundos y validado en el backend (§3)Sin pendientes: el código se calcula en el teléfono (decisión del 16/11/2026)
Identidad y recuperaciónEl DNI identifica, no autentica; sin vía de recuperación definidaSegundo factor, política de sesión y procedimiento de recuperación de cuenta
Autenticación del POSEl servicio actual no autentica; la propuesta solo indica "JWT"Credencial por caja o sucursal, emisión, rotación y revocación
Dueño del saldo en la convivenciaDos sistemas operativos sobre las mismas tarjetasDesignar un único sistema que escribe el saldo en cada etapa
Saneamiento previo a la migraciónEl saldo acotado a 0 puede ocultar sobregiros; la auditoría contiene PAN, PIN y DNI en claroConciliar saldos antes de migrar; no migrar datos sensibles en claro; rotar las credenciales versionadas
Beneficios y fiscalEl descuento al pago altera la base de la NCRegla de cálculo y de conciliación con la factura del acuerdo
Arquitectura"Microservicios / módulos", "SQL Server o PostgreSQL", "Flutter o React"Cerrar las tres; se sugiere iniciar como monolito modular
Nombre del servicio fiscalAparece como TiFacturaOnline, TiFacturaNext y TiFacturaOnlineNextUnificar el nombre y confirmar que la API REST existe y qué expone
Clearing inter-sociosDefinido que una tarjeta puede consumirse en otra razón social; el proceso de compensación está esbozado en §11Frecuencia de cierre, operador y garantía de pago, comisión por consumo cruzado y qué razón social emite la NC
Flujo financieroEl recorrido del dinero está descrito en §11, con puntos sin definirDestino del saldo vencido, quién financia el beneficio, comprobante de la venta de giftcard y modelo de cobro de Tipre
Carga masivaHoy se aplica parcialmente; §10 propone todo o nada con vista previaConfirmar el cambio de comportamiento
Marco legalTarjeta usable en varias razones sociales; tratamiento de datos del DNIValidar con legales si el producto sigue siendo de circuito cerrado y los requisitos de datos personales
▸
Decisiones tomadas (11/11/2026). Para la giftcard: PIN obligatorio en toda compra, contacto verificado obligatorio al reclamar y reclamo único con rotación de token (§6). Se descarta NFC como medio de presentación. El pase de Google Wallet / Apple Wallet fue evaluado y queda descartado por ahora (§6). Una tarjeta cargada en una razón social puede consumirse en otra, lo que requiere el clearing inter-socios (§11).
i
El repositorio no incluye el DDL de la base, por lo que las restricciones de unicidad y los tipos de columna reales no pudieron verificarse; conviene relevarlos directamente en producción.

Parte 2

Operaciones y flujo financiero

Diagrama de cada operación del nuevo producto, recorrido del dinero y compensación entre razones sociales (clearing inter-socios).

10

Diagramas de operación

Secuencia propuesta para cada operación, aplicando las reglas ya definidas: clave de idempotencia en toda operación que mueve saldo (§4), PIN en toda compra y reclamo único de la giftcard (§6). El pago en caja está en §4. Las rutas de la API son ilustrativas.

solicitud paso interno respuesta rama alternativa o de rechazo

Venta de giftcard en caja

Comprador POS API Cuenta / DB 1 · pide giftcard por $X y paga 2 · POST /ventas {importe, idTrx} 3 · crea cuenta · acredita saldo 4 · aprobada + enlace de reclamo 5 · entrega QR / enlace de reclamo alt · idTrx repetido: misma respuesta alt · pago no confirmado: sin saldo
La caja cobra y recién entonces solicita la venta. El backend crea la cuenta, acredita el saldo y devuelve el enlace de reclamo, que es un vale y no la tarjeta. Un reintento con el mismo idTrx devuelve la misma respuesta sin duplicar. La recarga de una tarjeta existente sigue la misma secuencia, sin emitir enlace.

Reclamo de la giftcard

Receptor App web API Cuenta / DB 1 · abre el enlace de reclamo 2 · valida el vale (un solo uso) 3 · envía código al teléfono o mail informado 4 · ingresa código y elige PIN 5 · POST /reclamos {vale, código, PIN} 6 · rota token · guarda hash PIN 7 · tarjeta activa + QR de pago alt · vale ya usado o vencido
El receptor verifica un contacto y elige su PIN. Al completar el reclamo el backend emite un token nuevo e invalida el vale, de modo que quien compró o reenvió el enlace ya no puede usar la tarjeta.

Anulación

POS API Cuenta / DB 1 · POST /pagos/{idTrx}/anulacion {idAnulacion} 2 · busca el pago · verifica que no esté anulado ni con NC 3 · acredita el importe y registra la anulación (atómico) 4 · anulada + nuevo saldo alt · misma idAnulacion repetida: mismo resultado alt · pago ya anulado o con NC emitida: rechazo
La anulación identifica el pago por su idTrx y lleva su propia clave. Un reintento devuelve el mismo resultado en lugar de rechazarse, a diferencia del comportamiento actual (§6 del estado actual). Si el pago ya tiene NC emitida, la devolución debe resolverse por el circuito fiscal y no por anulación.

Reverso por falta de respuesta

POS API Cuenta / DB 1 · POST /pagos {…, idTrx} · sin respuesta (timeout) 2 · POST /reversos {idTrx} 3 · ¿existe el pago idTrx? 4 · si existe y no fue reversado ni anulado: lo revierte una sola vez 5 · reversado, o «nada que reversar» alt · pago ya anulado: no vuelve a acreditar
El reverso resuelve la incertidumbre de la caja cuando no recibió respuesta. El backend revierte el pago como máximo una vez; si el pago no llegó a registrarse o ya fue anulado, no modifica el saldo. Esto elimina la doble devolución detectada en el sistema actual (§6 del estado actual).

Recuperación de PIN y reemisión

Titular App web API Cuenta / DB 1 · «olvidé mi PIN» 2 · solicita recuperación 3 · envía código al contacto verificado 4 · código + PIN nuevo 5 · POST /recuperaciones 6 · nuevo hash PIN · rota token 7 · QR nuevo; el anterior se invalida alt · código inválido · bloqueo a los 3–5
Solo el titular, a través de su contacto verificado, puede recuperar la tarjeta. La misma secuencia se usa para reemitirla ante sospecha de copia. El saldo se conserva y la operación queda registrada.

Carga masiva corporativa

Empresa (portal) API Cuenta / DB Empleado 1 · sube archivo y elige modo 2 · valida todas las filas 3 · vista previa: válidas y errores 4 · confirma {idCarga} 5 · aplica en una transacción 6 · invitación de reclamo (solo altas) 7 · resultado y comprobante alt · hay errores: no se aplica nada
El modo (alta, recarga o nuevo saldo) se elige en el portal y no por el nombre del archivo. Propuesta a confirmar: la carga pasa a ser todo o nada, con vista previa de errores antes de confirmar, en lugar de la aplicación parcial actual (§4 del estado actual).
11

Flujo financiero y clearing inter-socios

El documento describía el circuito fiscal (factura del acuerdo y notas de crédito) pero no el recorrido del dinero. Esta sección lo describe y agrega la compensación que hace falta cuando una tarjeta cargada en una razón social se consume en otra.

Flujo del dinero con una sola razón social

Canal corporativo Empresapaga el cupo Razón social emisoracobra · factura el acuerdo Empleadoconsume en caja dinero (anticipado) mercadería Canal giftcard Compradorpaga en caja Razón social emisoracobra la venta Receptorconsume en caja dinero mercadería saldo no consumido = obligación con el titular El dinero entra una sola vez, al cargar. El consumo en caja no mueve dinero: reduce la obligación.
Con una sola razón social no hay compensación: quien cobra la carga es quien entrega la mercadería. El saldo pendiente es una obligación de la razón social emisora con el titular; su tratamiento contable debe validarse con el área contable.
EventoMovimiento de dineroEfecto en el saldoComprobante
Alta o renovación de acuerdoLa empresa paga a la razón social emisoraAumenta el cupo a distribuirFactura del acuerdo (§5)
Venta o recarga de giftcardEl comprador paga en cajaAumenta el saldo de la tarjetaA definir: comprobante de la venta de la giftcard
Consumo en la razón social emisoraNingunoDisminuyeTicket de la compra y NC según el circuito fiscal (§7 del estado actual)
Consumo en otra razón socialNinguno en caja; genera una posición a compensarDisminuyeTicket de la razón social de consumo; tratamiento de la NC a definir
Anulación o reversoNinguno; revierte la posición a compensar si la huboSe restituye—
Vencimiento con saldo remanenteNingunoSe extingueA definir

Clearing inter-socios

Está definido que una tarjeta cargada en una razón social puede consumirse en otra. En ese caso el socio que cobró la carga no es el que entregó la mercadería, y hace falta compensarlo. Se denomina socio a cada razón social adherida al producto y clearing inter-socios al proceso periódico que calcula y liquida esas posiciones.

Tarjeta cargada en el socio A y consumida en el socio B Socio A · emisorcobró la carga Clearingposición neta por período Socio B · consumoentregó la mercadería consumos de A en B liquidación pago neto del socio deudor al acreedor Cada consumo registra la razón social emisora y la de consumo. Los saldos cruzados se compensan y solo se paga la diferencia.
El clearing recibe los consumos cruzados, calcula la posición neta de cada socio al cierre del período y emite la liquidación. Solo se transfiere la diferencia.
  1. Registro: cada consumo guarda la razón social emisora de la tarjeta y la razón social donde se consumió. Si coinciden, no genera posición.
  2. Cierre del período: se suman los consumos cruzados de cada par de socios y se compensan entre sí.
  3. Liquidación: se informa a cada socio su posición neta, con el detalle de transacciones que la respalda.
  4. Pago: el socio deudor transfiere la diferencia al acreedor.
  5. Ajustes: las anulaciones y reversos posteriores al cierre se imputan al período siguiente.
Ejemplo de un períodoImporte
Tarjetas del socio A consumidas en el socio B$ 100.000
Tarjetas del socio B consumidas en el socio A$ 30.000
Posición neta: el socio A paga al socio B$ 70.000
!
Impacto en el modelo. La razón social emisora y la de consumo deben registrarse en cada transacción desde la fase 0 (§8); agregarlas después obliga a reconstruir el historial. El clearing necesita además un registro propio de períodos, posiciones y liquidaciones.
!
Definiciones pendientes. Frecuencia del cierre; quién opera el clearing y quién responde si un socio no paga; si existe una comisión por consumo cruzado; qué razón social emite la NC cuando el acuerdo lo facturó un socio y el consumo ocurrió en otro; destino del saldo vencido; quién financia el beneficio o descuento; y el modelo de cobro de Tipre. Las cuestiones fiscales y contables deben validarse con el área contable y con legales (ver §9).
A

Anexo · Historial de versiones

Registro de cambios del documento. Cada versión nueva agrega una fila al inicio de la tabla. Las entradas de v1 a v4 citan las secciones con la numeración de esas versiones; la tabla de equivalencias está en la entrada de v5.

VersiónFechaCambios
v816/11/2026 Diagramas de presentación. La vista general del inicio pasa a ser un flujo en dos bloques (carga del saldo y consumo en caja). El mapa de la plataforma, con actores y funciones numerados, se rediseña y se ubica en §2, antes de la vista técnica de componentes.
v716/11/2026 Vista general del sistema. Diagrama nuevo al inicio del documento: quién opera la plataforma, qué resuelve y sus atributos principales.
Decisión registrada. El código del QR dinámico se calcula en el teléfono (§3, §9); se descarta calcularlo en el backend.
v616/11/2026 QR dinámico definido. §3: apartado nuevo «QR dinámico: generación y validación», con formato del QR, intervalo de 30 segundos, control de un solo uso, diagrama de secuencia, pasos de validación en el backend y tabla de situaciones cubiertas.
Ajustes. §4: el paso de validación del diagrama de pago incluye QR y PIN. §6: nota de revisión sobre el pase de Wallet; el descarte se mantiene. §9: la fila «Tipo de QR» queda resuelta salvo dónde se calcula el código.
v516/11/2026 Documento reducido a la propuesta. Se retira la Parte 1 (estado actual, §1 a §8 de las versiones anteriores), que queda como documento separado en la versión 4.
Renumeración. Las secciones §9 a §19 pasan a ser §1 a §11 (cada número disminuye en 8); la propuesta pasa a ser la Parte 1 y operaciones y flujo financiero, la Parte 2.
Referencias. Las citas a secciones retiradas quedan como «§n del estado actual». Título, encabezado y pie actualizados.
Presentación. El tema claro es el predeterminado, sin depender de la configuración del sistema; el oscuro queda disponible con el botón.
v411/11/2026 Parte 3 nueva: operaciones y flujo financiero. §18: diagramas de secuencia de venta de giftcard, reclamo, anulación, reverso, recuperación de PIN y carga masiva. §19: flujo del dinero con una razón social, tabla de eventos financieros y clearing inter-socios con ejemplo de liquidación.
Decisión registrada. Una tarjeta cargada en una razón social puede consumirse en otra (§13, §17).
Ajustes. §12: el pago incluye el PIN en la solicitud. §17: filas de clearing inter-socios, flujo financiero y carga masiva.
Presentación. Rediseño visual: logo de Tipre en el encabezado y en el índice lateral, fondos neutros y rojo anaranjado como único color de acento.
v311/11/2026 Pase de Google Wallet / Apple Wallet: evaluado y descartado por ahora. §14: nota con la alternativa evaluada y los motivos del descarte. §16: la fase 5 incluye el esquema de seguridad de la giftcard. §17: el descarte figura entre las decisiones tomadas.
Presentación. Paleta de colores alineada con el logo de Tipre (negro y rojo anaranjado), en tema claro y oscuro.
v211/11/2026 Parte 1 contrastada contra el código. §4: tres modos de carga masiva según el prefijo del archivo y confirmación parcial. §5: estado inicial Operativa con los controles apagados. §6: operación 21 (ajuste de saldo), id 14 compartido, anulación sin validación de fecha, límites de la idempotencia. §7: la NC es siempre tipo B, por importe total, con IVA fijo del 21% y condicional por cliente; prorrateo, NC A y tablas de detalle figuran como no implementados. §8: filas de seguridad, consistencia de saldo y facturación.
Parte 2. §9, §10 y §15: el alcance fiscal a reutilizar se limita al circuito de NC B; el resto es desarrollo nuevo. §11: puntos a resolver sobre QR estático, DNI, recuperación y enlace de activación. §12: clave de idempotencia idTrx, débito atómico y autenticación de la caja. §13: beneficio contra base de la NC, conciliación y CAEA. §14: esquema de seguridad de la giftcard (reclamo único, PIN siempre, contacto verificado obligatorio) y reglas de recuperación. §16: observaciones sobre el orden de las fases.
Secciones nuevas. §17 Riesgos y decisiones abiertas; Anexo A.
v109/11/2026Versión inicial: estado actual (Parte 1) y propuesta de nuevo producto (Parte 2).