1. La respuesta corta
El cliente elige en la billetera; el POS no elige nada. El POS nunca ve la tarjeta: los BINs le llegan al gateway desde Prisma v27 p.19. El POS manda por QR el importe a cobrar, y se entera del medio, de las cuotas y del importe final cuando el pago ya está aprobado. Entonces imputa la diferencia, sea un descuento o un recargo, y cierra el ticket por lo efectivamente cobrado. Es un esquema postpago.
¿De dónde salen los planes? De la configuración del gateway: los planes se configuran en la consola, por comercio y sucursal, con vigencia, días de la semana, monto mínimo y diferencias por sucursal. El comercio no necesita cambiar nada en el POS para ofrecer planes.
Un ejemplo de punta a punta:
| Paso | Qué pasa | Montos |
|---|---|---|
| 1 | El POS pide cobrar $ 1.000 por QR y el comercio tiene 6 cuotas con +20 % para Mastercard | importe 1.000 |
| 2 | El cliente elige en la billetera «Mastercard, 6 cuotas» | la billetera cobra 1.200 |
| 3 | El gateway devuelve el resultado al POS | importe 1.000 · importe_final 1.200 · recdesc +200 · cuotas 6 |
| 4 | El POS cierra el ticket | venta 1.000 + recargo 200 · medio QR 1.200 |
Con un descuento el camino es el mismo, con signo negativo: un plan de 1 pago al −10 % sobre $ 1.000 devuelve importe_final 900 y recdesc −100, y el POS imputa el descuento y cierra por 900. Los recargos y los descuentos están construidos y probados, pero su uso en producción depende de la respuesta de Prisma a la pregunta 10 (§12).
2. De dónde salen los planes
Los planes se configuran en el gateway (consola), por comercio y sucursal. Aplican recargos y descuentos, producen un OfferedPlans por tarjeta y respetan las reglas de Prisma (1 cuota siempre, medio 112 siempre).
| Cómo funciona | |
|---|---|
| Fuente de verdad | La tabla installment_plan del gateway, por comercio |
| Cómo se cargan | Desde la consola (rol ADMIN) o, en desarrollo, con SQL de semilla |
| Qué trae cada plan | Medio, banco, rango de BIN, cuotas, % con signo, TNA y CFT, vigencia, días, monto mínimo, sucursal |
| Qué gana | Entre los planes vigentes, el más específico: la sucursal sobre el comercio y, dentro del mismo alcance, rango de BIN > banco > medio (AC-13) |
| Empates | La consola rechaza dos planes que empaten |
| Vigencias, días, mínimo | El gateway las filtra con la fecha del servidor, en la zona horaria de los comercios |
| Diferencias por sucursal | Plan con sucursal propia que reemplaza al del comercio |
| Cambio necesario en el POS | Ninguno para ofrecer planes |
| Consola de planes | Alta, edición, deshabilitación y simulador (S5) |
El POS necesita la imputación postpago (§10): el resultado que vuelve es importe, importe_final y importe_recdesc con signo.
3. En qué momento se decide
%%{init: {"sequence": {"wrap": true, "width": 180}}}%%
sequenceDiagram
autonumber
participant POS
participant GW as GatewayPrismaQR
participant PR as Prisma
participant W as Billetera
POS->>GW: trxpago con importe 100.000
GW->>GW: usa la tabla de planes del comercio y de la sucursal
GW->>PR: crear intención (original_amount 100.000)
W->>PR: escanea el QR, el cliente tiene 3 tarjetas cargadas
PR->>GW: BINs 450799 Visa Galicia, 520048 MC Macro, 491511 Visa Débito Santander
GW->>GW: match del BIN con los planes (milisegundos)
GW->>PR: intención completa (por tarjeta: 1, 3, 6 y 12 cuotas con sus montos)
PR->>W: muestra las opciones
W->>PR: el cliente elige MC Macro, 6 cuotas
PR->>GW: notificación con amount 112.000 e installments 6
GW-->>POS: importe 100.000, importe_final 112.000, recdesc +12.000, cuotas 6
POS->>POS: imputa el recargo postpago y cierra el ticket
Cuando Prisma manda los BINs, el gateway ya tiene los planes en la base: el match tarda milisegundos y el presupuesto de 27 s v27 p.22 se va en la red, no en el cálculo.
4. Qué dice Prisma v27 (hechos)
| Regla | Fuente |
|---|---|
Cada medio de pago de la intención completa lleva installments con quantity, total_amount, amount_per_installment, cft y tna. |
v27 p.22–30 |
| El plan de 1 cuota es obligatorio en cada medio que mandamos. | v27 p.24 |
| El medio 112 (Transferencias 3.0) va siempre. | v27 p.24 |
Con cada BIN, Prisma manda payment_method_id y bank_id (código BCRA). |
v27 p.19 |
El único ejemplo con cuotas es 6 × 200 = 1.200 = original (sin interés). No hay ejemplo con total_amount distinto del original. |
v27 p.27 |
La notificación devuelve amount (lo cobrado) e installments (las cuotas elegidas). |
v27 p.35–47 |
| El cashback solo existe con Visa Débito. | v27 p.97 |
Conclusión: que Prisma acepte un total_amount distinto del original_amount, mayor o menor, es una suposición hasta que conteste la pregunta 10 (§12). El sistema se construye con recargos y descuentos activos, pero habilitarlos en producción depende de esa respuesta.
5. Lo que ya existe en el POS
5.1 Rangos y planes
flowchart TB
PAN["Número de tarjeta"] --> BANDA["dM_Banda<br/>ordenada por iOrden<br/>cDesde · cHasta · iDigmin · iDigmax"]
BANDA -- "primer rango que matchea" --> RANGO["iIdRango"]
RANGO --> TARPL["dM_TarPl<br/>cPlan · iCuotas · iPlan<br/>cComercio · fRecDescMPP · bHabilitado"]
TARPL --> VENTA["Venta con recargo o descuento<br/>idRECARGO_DESCUENTO"]
| Pieza | Qué hace | Fuente |
|---|---|---|
IdentifyDataCard |
Recorre dM_Banda por iOrden y se queda con la primera fila que matchea: compara el PAN por prefijo contra cDesde y cHasta y verifica el largo con iDigmin e iDigmax. |
POS pos_card.cpp:2903 |
dM_TarPl |
Planes por rango: nombre, cuotas, código de plan, moneda, número de comercio y fRecDescMPP (recargo o descuento %). |
POS pos_card.cpp:2448-2499 |
idRECARGO_DESCUENTO (17) |
Movimiento con signo que registra el recargo o descuento en dE_TMdeP. |
POS de referencia pos_defi.h:562 |
Lo que no tienen las tablas del POS: vigencia por fechas y días de la semana. Hoy el comercio las maneja actualizando las tablas. En el gateway esas columnas existen en cada plan.
5.2 Redondeo del POS
| Función | Qué hace | Fuente |
|---|---|---|
ROUND_DOUBLE(d) |
Redondeo a 2 decimales alejándose del cero: floor(abs(d) × 100 + 0,5 + 1e-10) / 100 con el signo repuesto (ROUND_DOUBLE3; el 0,50000001 de la versión vieja está comentado). |
POS pos_misc.cpp:978-1010 |
| Motor de promociones por medio de pago | ROUND_DOUBLE((ROUND_DOUBLE(importe) × ROUND_DOUBLE(%)) / 100): el porcentaje se redondea a 2 decimales al leer la promoción (pos_prom.cpp:4417) y hay un solo redondeo del cociente, que el POS omite si el resultado es de 0,0099999 o menos (pos_prom.cpp:4683). Es lo que el POS muestra e imprime como recargo o descuento del plan de cuotas que elige el cajero. |
POS pos_prom.cpp (PromocionesMdeP_Consultar), pos_mppo.cpp:4193 |
RoundExp100(x) |
redondeo2(redondeo2(x) / 100): dos redondeos. Lo usa el POS para impuestos, límites de vuelto y el recargo fijo de un medio de pago cuando las promociones por medio están apagadas; no es el plan de cuotas. |
POS pos_mis2.cpp:1287, pos_mppo.cpp:264-299 |
dM_TarPl.fRecDescMPP |
La tabla lo documenta como porcentaje, pero su único consumidor lo toma directo como importe (sin cálculo ni redondeo) para una tarjeta pre-leída que el motor de promociones no valorizó. | POS pos_mis2.cpp:3857-3858 |
El gateway usa el redondeo del motor de promociones (un solo redondeo): un plan del gateway reemplaza al plan de cuotas que el POS imprimiría para la misma tarjeta. Con RoundExp100 daría un centavo de más cuando el primer redondeo cae en medio centavo: 1.000,11 al 4,5 % es 45,00 con el motor y 45,01 con RoundExp100. El gateway calcula en double con las mismas operaciones que el POS (si no, un empate exacto como 173.244,75 al 10 % daría 17.324,48 donde el POS da 17.324,47). Que la medición sobre un POS real confirme esto está abierto (AC-14, D-S3-9).
6. Planes del gateway
6.1 Qué guarda cada plan
Tabla installment_plan, por comercio:
| Campo | Significado |
|---|---|
payment_method_id, bank_id? |
Medio de pago de Prisma y, opcionalmente, el banco (código BCRA) |
bin_from?, bin_to? |
Rango de BIN como prefijos de texto (conserva ceros a la izquierda), comparados como el strncmp del POS |
quantity, adjustment_pct |
Cantidad de cuotas y porcentaje con signo |
tna, cft |
Tasas, que se envían a Prisma cuando hay recargo |
plan_code? |
Código del plan, por ejemplo Cuotas MiPyME 13 y 16 |
valid_from, valid_to, weekdays?, min_amount? |
Vigencia, días de la semana (máscara de bits, vacío = todos) y monto mínimo |
branch_id? |
Plan propio de una sucursal, que reemplaza al del comercio |
enabled |
Habilitado |
El plan de 1 cuota es implícito y nunca se guarda: siempre se ofrece. Un plan de 1 cuota con descuento lo reemplaza; uno con recargo se rechaza.
6.2 Cómo se resuelve
flowchart TB
START["BIN, medio y banco de Prisma<br/>más importe, fecha y sucursal"] --> ACC{"¿Medio aceptado<br/>por el comercio?"}
ACC -- "no" --> NOACC["No se ofrece"]
ACC -- "sí" --> CAND["Candidatos: planes habilitados<br/>del comercio para ese medio"]
CAND --> F1{"¿Coinciden banco y rango de BIN<br/>cuando el plan los fija?"}
F1 -- "no" --> OUT["Se descarta"]
F1 -- "sí" --> F2{"¿Está vigente hoy, aplica este día<br/>y el importe llega al mínimo?"}
F2 -- "no" --> OUT
F2 -- "sí" --> G["Por cada cantidad de cuotas<br/>gana el plan más específico"]
G --> S["La sucursal gana sobre el comercio<br/>y, dentro del mismo alcance,<br/>rango de BIN sobre banco<br/>y banco sobre medio"]
S --> DONE["Una ganadora por cantidad de cuotas<br/>más 1 pago sin ajuste si falta"]
El ajuste se calcula siempre sobre todo el importe QR. La sucursal manda sobre el comercio y recién después se compara la tarjeta (la sucursal que tiene su propio plan reemplaza lo que el comercio fijó para ella).
- Empates (AC-13). Dos planes que empatan en especificidad para la misma tarjeta, día y cantidad de cuotas son un error de configuración: la consola se niega a guardarlos (un 409 que nombra el plan en conflicto). Si igual hubiera uno, el gateway no ofrece nada y traspasa el pago a compensación; nunca adivina cuál quiso el comercio.
- Comparación de BIN: por prefijo,
BIN[0:len(desde)] ≥ desdeyBIN[0:len(hasta)] ≤ hasta, igual que elstrncmpdel POS. Prisma no informa el largo del PAN, así queiDigmineiDigmaxno se pueden evaluar, y un límite de más de 8 dígitos no se puede decidir con el BIN (R-08). - Medio de pago: el plan tiene que coincidir con el
payment_method_idde Prisma. Esto evita que una Visa débito caiga en un rango genérico «4» pensado para Visa crédito. Un BIN de un medio que el comercio no acepta no se ofrece. - Planes que no se pueden ofrecer conservan su lugar. Un plan con recargo sin tasas válidas, o que no deja nada por pagar, se guarda marcado como no ofrecible y sigue ganando esa cantidad de cuotas para las tarjetas que cubre, de modo que un plan menos específico no puede ofrecerles esas cuotas a un precio que el comercio no fijó. Solo se omite un plan cuando no se puede leer su tarjeta o su cantidad de cuotas.
- Sin ganador: la tarjeta va en 1 pago sin ajuste, siempre que el medio esté aceptado.
- Simulador de la consola: dado un comercio, un BIN y un importe muestra, plan por plan, si se ofrece y por qué no (otra sucursal, fuera de vigencia, otro día, bajo el mínimo, superado por otro plan, empate), con las mismas clases que el trabajador de BINs.
7. Cómo se calculan los montos
Son los del POS:
| Concepto | Fórmula | Ejemplo (100.000; 6 cuotas +12 %) |
|---|---|---|
| Recargo o descuento | rd = redondeo2((redondeo2(importe) × redondeo2(%)) / 100), un solo redondeo (motor de promociones del POS, §5.2) |
12.000,00 |
| Total del plan | total = importe + rd |
112.000,00 |
| Valor de la cuota | cuota = redondeo2(total / cuotas), mitad hacia arriba |
18.666,67 |
| Diferencia por redondeo | cuota × cuotas − total |
+0,02 (pregunta 11 a Prisma) |
| Lo que vuelve al POS | recdesc = amount − importe |
+12.000,00 |
- TNA y CFT: los datos de cada plan vienen del adquirente o del banco; el gateway solo verifica la coherencia con el ajuste. Calcularlos nosotros mete una responsabilidad regulatoria que no corresponde. Ilustrativo, con sistema francés e IVA del 21 % sobre el interés: 6 cuotas +12 % da TNA 40,05 % y CFT 61,87 %; 12 cuotas +25 % da TNA 43,34 % y CFT 68,28 %.
- Cashback: solo con Visa Débito y en 1 pago v27 p.97. El ajuste se aplica sobre la compra, nunca sobre el efectivo (AC-17). El efectivo viaja aparte (
cashback_max_amount, conabsolute_cashbackactivo por defecto) y la notificación se honra solo si el retiro es exactamente lo pedido, en Visa Débito y en 1 pago; sin retiro la venta sigue, y cualquier otra cosa se compensa. El POS recibe entotalcashbacklo que el cliente retiró. Quéamountinforma Prisma con cashback es una duda abierta (preguntas 21 y 22). - Cuotas MiPyME: los planes 13 (3 cuotas) y 16 (6 cuotas) se ofrecen con su código de plan cuando están configurados (AC-16). El objeto
installments[]de Prisma no tiene un campo de código de plan: cómo se indica es la pregunta 9; hasta que conteste, el código no viaja a Prisma y AC-16 sigue abierto.
8. Ejemplo y simulador
Almacor, ticket de $ 100.000 por QR. Los medios aceptados son 1, 31, 104, 105, 106 y 112; Amex (65) no está aceptado.
Planes del gateway, vigentes del 2026-10-01 al 2026-10-31:
| Plan | Medio | Banco | Cuotas | Ajuste | Días | Mínimo |
|---|---|---|---|---|---|---|
| 1 | Visa crédito (1) | todos | 3 | 0 % | todos | — |
| 2 | Mastercard crédito (104) | todos | 3 | 0 % | todos | — |
| 3 | Visa crédito (1) | Galicia | 6 | 0 % | martes y jueves | — |
| 4 | Visa crédito (1) | todos | 6 | +12 % | todos | — |
| 5 | Mastercard crédito (104) | todos | 6 | +12 % | todos | — |
| 6 | Mastercard crédito (104) | todos | 12 | +25 % | todos | $ 50.000 |
| 7 | Visa Débito (31) | Santander | 1 | −10 % | martes | — |
Para 6 cuotas, la Visa de Galicia gana el plan 3 (banco, más específico) los martes y jueves y el plan 4 el resto de los días. La fecha por defecto es el martes 2026-10-06.
Simulador
Elija el importe del QR, la fecha y la tarjeta que trae el cliente. El simulador aplica la resolución de planes de §6.2 sobre la tabla de arriba, arma la oferta para Prisma y muestra qué vuelve al POS según el plan elegido.
1 · Resolución de planes (§6.2)
2 · Oferta a Prisma (intención completa)
| Cuotas | Ajuste | Total | Cuota |
|---|
3 · Respuesta al POS (plan elegido)
9. El ciclo de vida del ajuste
flowchart TB
A["Planes del gateway<br/>(installment_plan)"] --> C["Match del BIN<br/>(gateway)"]
C --> D["installments.total_amount<br/>(intención completa)"]
D --> E["El cliente elige<br/>(billetera)"]
E --> F["notificación.amount<br/>más installments"]
F --> G["recdesc = amount − importe<br/>(gateway)"]
G --> H["Imputación postpago<br/>(POS)"]
Lo que vuelve al POS:
| Elección del cliente | importe |
importe_final |
importe_recdesc |
cuotas |
|---|---|---|---|---|
| Visa Galicia, 6 sin interés | 100.000,00 | 100.000,00 | 0,00 | 6 |
| MC Macro, 6 cuotas +12 % | 100.000,00 | 112.000,00 | +12.000,00 | 6 |
| Visa Débito Santander, 1 pago −10 % | 100.000,00 | 90.000,00 | −10.000,00 | 1 |
La regla no cambia: importe + importe_recdesc == importe_final, al centavo (INV-04).
10. La imputación en el POS
El documento de referencia de la imputación (flujo, reparto por alícuota de IVA, percepciones, impresión, casos de prueba y brechas del POS de Almacor) es POS-IMPUTACION-QR.md (pos-imputacion-qr.html). Aquí queda solo el resumen.
10.1 Cómo cierra el POS (postpago)
Después de la aprobación, el POS recibe importe, importe_final e importe_recdesc y cierra por lo que cobró la billetera: verifica que los importes cierren, escribe filas de detalle por alícuota de IVA con el IVA recalculado desde el neto, recalcula las percepciones y registra idRECARGO_DESCUENTO con signo. El paso a paso, con el reparto del centavo residual, está en POS-IMPUTACION-QR.md §3.2 a §3.6.
10.2 Descuento y recargo
Los dos son de primera clase en el gateway: el POS imputa el que corresponda al signo de importe_recdesc. En el POS de referencia el descuento tiene imputación y el recargo no: las filas positivas, el IVA del recargo financiero (con definición impositiva pendiente), las percepciones y el comando fiscal son trabajo abierto. La comparación pieza por pieza está en POS-IMPUTACION-QR.md §3.9.
10.3 El peligro de hoy
En el POS de referencia, si llega un recdesc positivo, la imputación devuelve 0 y el llamador lo ignora: la venta queda registrada por el importe original mientras la billetera cobró más, sin reversa ni error visible (leído en el código, no ejecutado). Es el riesgo R-04; el detalle está en POS-IMPUTACION-QR.md §3.2.
Regla (INV-06): el POS nunca registra una venta QR por un importe distinto del que cobró la billetera. Si no puede imputar, falla en forma explícita y dispara la reversa del pago.
10.4 Almacor y Becerra
En Almacor, el POS leía importe_recdesc y no lo imputaba. El port está hecho en la rama feat/qr-imputation del repositorio tipre/POS_ALMACOR y no está integrado: la línea base 20261003 sigue en main. El estado del trabajo del lado del POS está en SISTEMA.md §2. El estado del POS de Becerra no se verificó en esta revisión; sigue incluido en la dependencia R-07.
11. Riesgos
Los riesgos que afectan a lo que explica este documento son R-04 a R-08. Su nivel y su mitigación están en SISTEMA.md §16 (sistema.html) y, con su dueño, en RISKS.md.
- R-04: el POS registra la venta por el importe original cuando le llega un recargo (§10.3).
- R-05: impresora fiscal, comando de descuento y de recargo.
- R-06: tratamiento impositivo del recargo financiero.
- R-07: los ajustes necesitan una versión nueva del POS.
- R-08: límites de BIN de más de 8 dígitos.
12. Preguntas que hay que cerrar con Prisma
La numeración y el texto de cada pregunta son los de PRISMA-PREGUNTAS.md, que también dice qué depende de cada respuesta. Las que condicionan lo que explica este documento son:
- 10, la más importante: de ella depende habilitar recargos y descuentos en producción (§1, §4).
- 11 y 12: redondeo de la cuota e importe de la notificación (§7).
- 13: BIN de un medio no aceptado.
- 8 y 9: formato de
cftytna, y código de Cuotas MiPyME (§7). - 21 y 22: cashback (§7).
13. Decisiones
| # | Decisión | Fuente |
|---|---|---|
| D1 | Los planes se configuran en el gateway (consola), por comercio y sucursal. | ADR-003, AC-18 |
| D2 | Recargos y descuentos activos desde el inicio. Su uso en producción depende de la pregunta 10 y de la imputación en el POS. | SPEC §3 |
| D3 | 1 pago sin ajuste siempre en todo medio aceptado; el medio 112 siempre. | v27, AC-08 |
| D4 | Se filtra por vigencia, día y mínimo y gana el más específico: la sucursal sobre el comercio y, después, rango de BIN > banco > medio; la consola rechaza empates. | AC-13 |
| D5 | El gateway calcula como el POS: mitad alejándose del cero, con el único redondeo del motor de promociones por medio de pago (no el doble de RoundExp100). |
AC-14 |
| D6 | TNA y CFT los aporta el adquirente o el banco; el gateway solo verifica la coherencia. | AC-15 |
| D7 | El POS cierra postpago, por lo cobrado; si no puede imputar, falla y revierte. | INV-06 |
| D8 | Los límites de BIN indecidibles (más de 8 dígitos) se saltean y se registran. | R-08 |