GatewayPrismaQR · planes, recargos y descuentos · versión 5 · 2026-11-01

Planes de cuotas QR

Cómo se ofrecen cuotas, recargos y descuentos por BIN en un cobro QR: los planes se configuran en el gateway (consola), por comercio y sucursal; el cliente elige en la billetera y el POS imputa la diferencia después de la aprobación. Incluye un simulador interactivo.

Fuente de los planes
consola del gateway · por comercio y sucursal
Ajustes
descuentos y recargos con signo · importe_recdesc
Cierre en el POS
postpago, por lo efectivamente cobrado
A cerrar con Prisma
8 preguntas (la 10 es crítica)

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).


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

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)

    CuotasAjusteTotalCuota

    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.


    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:


    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