Cuotas

Esta función divide el precio total a pagar en varios importes más pequeños e iguales que se deben pagar durante un período de tiempo acordado, en lugar de exigir al cliente que pague todo por adelantado en un solo pago. Este método se usa ampliamente en los mercados de Latinoamérica y permite a los clientes tener una mayor flexibilidad, pero su implementación depende de la disponibilidad de tarjetas y debe cumplir con las regulaciones regionales.

A continuación se muestran las marcas de tarjetas disponibles que admiten pagos en cuotas en cada país

Esquema de tarjetas disponibleArgentinaBrasilChileMexicoUruguay
Amex-
Cabal----
Carnet----
Elo----
Hipercard----
Mastercard
Naranja----
Visa
Visa
OCA - Mastercard----

Generación de ID de cotización

Al implementar las cuotas en mercados de Argentina y Chile, será obligatorio cumplir con el valor quote_id en las solicitudes de cuotas de la API para que las transacciones se puedan procesar correctamente. Este campo se usa para calcular las tasas de interés, los impuestos y otros requisitos antes de la autorización de pago.

Cálculos de tasas de interés Para este proceso contamos con dos alternativas para comerciantes y socios, según sus necesidades:

  • Calculado por el usuario: el comerciante calcula las comisiones de interés de forma externa e informa a la API a través del campo amount. En las llamadas a la API, el quote_id debe incluirse como no_interest;
  • Calculado por GetNet: el comerciante delega los cálculos de las comisiones de interés en Getnet, que cuenta con información actualizada del emisor/gobierno y, por lo tanto, no tendrá que realizarlos de forma externa. En las llamadas a la API, quote_id debe generarse como with_interest.

Cuotas de Argentina

Para Argentina, hay dos tipos principales de opciones de pago en cuotas que se ofrecen a nivel país y solo se pueden procesar con tarjetas nacionales:

  • Planes de emisores: Los emisores/bancos ofrecen planes de cuotas base.
  • Planes gubernamentales (Cuota Simple/Plan Ahora): La opción ofrecida por el gobierno argentino suele tener tasas de interés más bajas que las del plan del emisor.

A continuación se muestran los posibles valores de los planes presentes en la API y diferenciados por marca de tarjeta en Argentina

Esquema de tarjetas disponibleNombre del planClave del plan (esquema)
AmexPlan de cuotas Amexplan_n
AmexCuota simpleplan_ahora
MastercardPlan Emisorplan_emisor
MastercardCuota simpleplan_ahora
NaranjaPlan Emisorpago_en_cuota
NaranjaPlan Z(not supported)
VisaPlan Emisorplan_emisor_accelerated
VisaCuota simpleplan_ahora

Cuotas de Brasil

Para Brasil, hay dos tipos principales de opciones de pago en cuotas que se ofrecen a nivel país:

  • Planes emisores (Parcelado Emisor): El comerciante liquidará la transacción solo una vez y el titular de la tarjeta pagará el importe total y las comisiones correspondientes que se apliquen posteriormente.
  • Cuotas comerciales (Parcelado Lojista): El comerciante liquidará las transacciones a plazos mes a mes (D+30), incluidos el MDR y las comisiones de descuento, y el titular de la tarjeta pagará el importe sin comisiones por intereses.

A continuación se muestran los posibles valores de los planes presentes en la API y diferenciados por marca de tarjeta en Brasil

Esquema de tarjetas disponibleNombre del planClave del plan (esquema)
AmexIssuer plan/Plan de emisoreswith_interest
AmexMerchant installment/Pago en cuotas para comerciantesno_interest
Elo--
Hipercard--
MastercardIssuer plan/Plan de emisoreswith_interest
MastercardMerchant installment/Pago en cuotas para comerciantesno_interest
VisaIssuer plan/Plan de emisoreswith_interest
VisaMerchant installment/Pago en cuotas para comerciantesno_interest

Cuotas en Chile

Para Chile, hay dos tipos principales de opciones de pago en cuotas que se ofrecen a nivel país:

  • Planes de emisores: Los emisores/bancos ofrecen planes de cuotas base con opciones que oscilan entre 2 y 48. El comerciante liquidará la transacción solo una vez y el titular de la tarjeta pagará el importe total y las comisiones correspondientes que se apliquen posteriormente.
  • Cuotas comerciales (Cuota Comercio): El comerciante ofrece un plan sin cargos con opciones que oscilan entre 2 y 12. El comerciante liquidará la transacción varias veces, según el plan seleccionado.

A continuación se muestran los posibles valores del plan presentes en la API y diferenciados por marca de tarjeta en Chile

Esquema de tarjetas disponibleNombre del planClave del plan (esquema)
MastercardPlan Emisorplan_emisor
MastercardCuota Comerciocuota_comercio
VisaPlan Emisorplan_emisor
VisaCuota Comerciocuota_comercio

Cuotas en México

Para México, solo se ofrece un tipo de opción de pago en cuotas a nivel país y, para que esté disponible para el comerciante, es necesario que sea activada y contratada durante el proceso de incorporación:

  • MSI (Meses sin interés): PROSA ofrece planes base de cuotas en los que el banco personal del cliente es responsable de cobrar los pagos, mientras que el comerciante recibirá una liquidación única que incluye cualquier tarifa deducida.

A continuación se muestran los posibles valores de los planes presentes en la API y diferenciados por marca de tarjeta en México

Esquema de tarjetas disponibleNombre del planClave del plan (esquema)
Amex-no_interest
Carnet-no_interest
MastercardPlan Prosano_interest
VisaPlan Prosano_interest

Cuotas en Uruguay

Para las transacciones en cuotas en Uruguay, deben cumplirse dos condiciones en la solicitud. La propiedad transaction_type, ubicada en el objeto payments dentro de data en el body de la solicitud, debe establecerse con el valor "FULL". Si bien en otros mercados se admiten valores como "INSTALL_NO_INTEREST" y "INSTALL_WITH_INTEREST", en Uruguay solo se permite el valor "FULL".

Además, se debe incluir un objeto installment dentro de additional_data. Este objeto debe contener las siguientes propiedades:

  • type: Identificador que representa el tipo de crédito.
  • schema: Código que agrupa los créditos por categoría. Este valor es siempre fijo como "Q" en la respuesta.
  • number: Cantidad de cuotas disponibles para el crédito. Los valores posibles van de 1 a 12 (en casos excepcionales, puede extenderse hasta 24 cuotas mediante acuerdos comerciales específicos).
  • code: Código único asociado a la oferta de crédito específica. Este valor es siempre fijo como "00" en la respuesta.

Los valores de estos campos deben obtenerse previamente mediante el servicio POST /dpm/payments-gwproxy/v2/payments/quotes.

Ejemplo:

"additional_data": {
  "installment": {
    "schema": "Q",
    "type": "00",
    "code": "00",
    "number": 2
  }
}

Observaciones al usar la API de pago en cuotas

Solicitud inicial

La API de Getnet espera recibir los siguientes detalles en la solicitud:

  • amount: Importe total a pagar.
  • bin: Los primeros 6 o 9 dígitos de la tarjeta (preferiblemente 9; en caso de Uruguay, se requieren 16 dígitos).
  • installment_type_filter: Propiedad opcional que solo puede tener dos valores posibles: no_interest o with_interest.

Respuesta

Deberás extraer las siguientes propiedades recibidas en el cuerpo de la respuesta HTTP 201 Created para usarlas en el siguiente paso:

  • quote_id
  • schema

Para más detalles consulte la API reference

Crear un pago

Una vez que el cliente haya seleccionado su cotización preferida, la API de Getnet espera recibir los siguientes detalles en el cuerpo de la solicitud de pago:

  • data: Objeto de primer nivel.
  • additional_data: Objeto de segundo nivel (dentro de data).
  • installment: Objeto opcional de tercer nivel (dentro de additional_data) donde quote_id y schema debe colocarse obligatoriamente. Si el objeto installment está incluido, el pago se realizará de acuerdo al número de cuotas previamente definido; de lo contrario, el pago se realizará en una sola cuota.