Cuotas

Ámbito regional: Las especificaciones y requisitos detallados en esta página se aplican exclusivamente a las integraciones Host-to-Host para operaciones de Pinpad en Argentina.

Getnet proporciona un endpoint especializado para consultar planes de cuotas, que aplica automáticamente los intereses y las promociones correspondientes. Esta sección describe los procedimientos obligatorios para gestionar transacciones en cuotas en el mercado argentino.

Consulta de cuotas y QUOTE ID

Para muchos esquemas de cuotas, el Sistema Host debe invocar el endpoint de cuotas de Getnet antes de iniciar la transacción. Este proceso es esencial para obtener un QUOTE ID, un identificador único que rastrea la transacción en cuotas en todo el ecosistema de Getnet. El QUOTE ID se devuelve en la respuesta asociada al plan específico y al número de cuotas seleccionado.

Matriz de requisitos

La siguiente tabla determina si un esquema de cuotas específico requiere una consulta obligatoria al endpoint para obtener un QUOTE ID:

Esquema de cuotas	¿Consulta requerida?
`plan_emisor`	Sí
`plan_emisor_accelerated`	Sí
`plan_ahora`	Sí
`cuota_simple`	Sí
`plan_n`	Sí
`pago_en_cuota`	Sí
`plan_amex`	Sí
`plan_z`	No
`alphanumeric`	No
`sin_interes`	No
`con_interes`	No
`plan_normal`	No
`plan_diferido`	No
`plan_especial`	No
`plan_convenio`	No
`plan_1`	No
`plan_2`	No
`plan_3`	No
`plan_4`	No
`cuotas`	No

Si un plan no requiere consulta, el socio debe enviar la transacción directamente, sin un quote_id.

Intereses y promociones

El Sistema Host tiene dos opciones para gestionar los cálculos financieros:

Cálculos autogestionados: Si el sistema del socio calcula los intereses y las promociones internamente, aun así debe realizar una consulta “SIN INTERESES” al endpoint para obtener el QUOTE ID necesario.
Cálculos gestionados por Getnet: Si el socio prefiere que Getnet realice los cálculos automáticamente, debe realizar una consulta (ya sea “SIN INTERESES” o “CON INTERESES”) según el método de pago seleccionado durante la venta.

Selección y conversión de cuotas

Getnet espera recibir el plan de pago exacto y el número de cuotas que el usuario seleccionó en la solicitud de la API.

Conversor de cuotas

En los casos en que el Sistema Host usa una “cantidad de cuotas” específica para identificar un plan, debe desarrollar y aplicar un conversor antes de enviar la solicitud a Getnet.

Ejemplo: Un sistema puede usar “11 cuotas” como código para identificar un Plan Emisor en 6 cuotas.
Acción: Cuando el operador introduce “11” en el sistema, el Sistema Host debe convertir este valor a “Plan Emisor 6 cuotas” y crear la solicitud con esos valores.

Cuotas con código QR

Para las transacciones que usan códigos QR, el flujo difiere de los pagos con tarjeta estándar:

Las transacciones deben generarse sin ningún cálculo previo de impuestos o intereses.
El cliente selecciona las cuotas deseadas directamente en su cartera digital.
La respuesta de la transacción devuelve toda la información necesaria al Punto de Venta (PDV) según la selección del cliente.

Siguientes pasos

Procesar Pagos con Tarjeta: envíe los valores de las cuotas dentro de la inicialización estándar Y19.
Procesar Pagos con Código QR: ejecute el flujo de cartera digital en el que el cliente elige las cuotas.
Tablas de Códigos: consulte los códigos de tipo de transacción y de tipo de cuenta que se usan en las solicitudes.