Getnet DocsGetnet Docs

Cuotas

Esta funcionalidad divide el precio total a pagar en varios importes menores e iguales que deben abonarse a lo largo de un período de tiempo acordado, en lugar de exigir al cliente que pague todo por adelantado en un único pago. Este método se utiliza ampliamente en los mercados de LATAM y permite a los clientes tener una mayor flexibilidad, pero su implementación depende de la disponibilidad de soporte de la tarjeta y debe cumplir con las normativas regionales.

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

Marca de tarjeta disponibleArgentinaBrasilChileMéxicoUruguayEspañaColombiaPortugal
Amex✅✅✅✅-✅--
Cabal✅-------
Carnet---✅----
Elo-✅------
Mastercard✅✅✅✅✅✅✅✅
Naranja✅-------
Visa✅✅✅✅✅✅✅✅
OCA - Mastercard----✅---

Petición inicial

La API de Getnet espera recibir los siguientes detalles en la petición:

AtributoTipoDescripciónEjemplo
amountintegerImporte total a pagar8900
binstringPrimeros 6 o 9 dígitos de la tarjeta*123412
installment_type_filterstringPropiedad opcional que solo puede tener dos valores posiblesno_interest o with_interest
number_tokenstringToken de la tarjeta que se utilizará en las transaccionesdfe05208b105578c070f806c80abd3a

*En el caso de Uruguay, se requieren los 16 dígitos de la tarjeta.

Ejemplo:

"data" {
  "amount": 8900,
  "bin": "123412",
  "installment_type_filter": "no_interest",
  "number_token": "dfe05208b105578c070f806c80abd3a"
}

Respuesta

Tendrá que extraer las siguientes propiedades recibidas en el cuerpo de la respuesta HTTP 201 Created para utilizarlas en el siguiente paso. Los valores de estos campos deben obtenerse de antemano a través del servicio POST /dpm/payments-gwproxy/v2/payments/quotes.

AtributoTipoDescripciónEjemplo
quote_idstringQuote ID a utilizar en la consulta06f256c8-1bbf-42bf-93b4-ce2041bfb87e
schemastringCódigo que agrupa los créditos por categoríaplan_n

Generación del Quote ID. Al implementar el pago a cuotas en los mercados de Argentina y Chile, será obligatorio proporcionar el valor de quote_id en las peticiones de cuotas a la API para que las transacciones puedan procesarse correctamente. Este campo se utiliza para calcular los tipos de interés, impuestos y otros requisitos previos a la autorización de un pago.

Para más detalles, consulte la Referencia de la API

Crear un pago a cuotas

Una vez que el cliente ha seleccionado su cotización (quote) preferida, la API de Getnet espera recibir los siguientes detalles en el cuerpo de la petición de pago:

| Atributo | Tipo | Descripción | Ejemplo | |---|---|---| |data| object | Objeto de primer nivel |-| |additional_data| object | Objeto de segundo nivel (dentro de data) |-| |transaction_type| string | El tipo de la transacción de pago |FULL| |number_ installments| integer | Número de cuotas disponibles para el crédito | 4 | |installment| object | Objeto opcional de tercer nivel (dentro de additional_data donde quote_id y schema deben incluirse de forma obligatoria). |-| |schema| string | Código que agrupa los créditos por categoría | PLAZOX | |type| string | Identificador que representa el tipo de crédito |no_interest| |quote_id| string | Quote ID a utilizar en la consulta |06f256c8-1bbf-42bf-93b4-ce2041bfb87e|

Ejemplo:

"additional_data": {
  "transaction_type": "PAYMENT",
  "number_ installments": 3,
  "installment": {
    "schema": "PLAZOX",
    "type": "no_interest",
    "quote_id": "4a29251d-41af-41fc-ac74-fa131e215e1b",
  }
}

Si se incluye el objeto installment, el pago se realizará de acuerdo con el número de cuotas previamente definido; de lo contrario, el pago se realizará en una sola cuota (pago único).

Para más detalles, consulte la Referencia de la API

Particularidades

Al crear pagos a cuotas en los mercados de Uruguay y España, hay algunas particularidades que deben aplicarse.

Uruguay

  • transaction_type debe establecerse como “INSTALL_NO_INTEREST”. Aunque otros valores como FULL e INSTALL_WITH_INTEREST son compatibles en otros mercados, solo INSTALL_NO_INTEREST es válido para Uruguay.
  • Los valores posibles de number_installments van del 1 al 12 (en casos excepcionales, puede haber hasta 24 cuotas disponibles a través de acuerdos comerciales específicos).
  • schema: este valor es siempre fijo como plan_al_eje.
  • type: este valor es siempre fijo como no_interest.

España

  • transaction_type debe establecerse como “PAYMENT” o “PREAUTHORIZATION”. Aunque se admiten otros valores en otros mercados, solo estos dos valores son válidos para España.
  • Los valores posibles para number_installments son 3, 6, 9 y 12.
  • schema: este valor es siempre fijo como PLAZOX.
  • type: este valor es siempre fijo como no_interest.

Cálculos de tasas de interés

Para este proceso, contamos con dos alternativas para los comercios (merchants) y partners, en función de sus necesidades:

  • Calculado por el usuario (Calculated by User): El comercio calcula las tasas 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 generarse bajo no_interest.
  • Calculado por Getnet (Calculated by GetNet): El comercio se basa en los cálculos de tasas de interés de Getnet, que cuentan con información actualizada del emisor/gobierno y, por lo tanto, no tendrá que realizarlos de forma externa. En las llamadas a la API, el quote_id debe generarse bajo with_interest.

Países disponibles

Las siguientes tablas muestran por país los tipos de opciones de pago a cuotas que se ofrecen. Consúltelas para comprobar las cuotas que se ofrecen en su país.

Cuotas en Argentina

Para Argentina, existen tres tipos principales de opciones de pago a cuotas que se ofrecen a nivel nacional, y solo pueden procesarse con tarjetas nacionales o domésticas:

  • Planes del emisor (Issuer plans): Los planes base de cuotas son ofrecidos por el emisor/bancos.
  • Planes del gobierno (Government plans - Cuota Simple / Plan Ahora): Opción ofrecida por el gobierno argentino, generalmente con tasas de interés más bajas que el plan del emisor.
  • Getnet Integral (Cuota a Cuota): Plan ofrecido por Getnet en el cual los comerciantes se liquidan cada mes igual al monto de las cuotas de la compra.

A continuación se muestran los posibles valores de plan de la API según la marca de tarjeta en Argentina

Marca de tarjeta disponibleNombre del planClave del plan (Schema)
AmexPlan de Cuotas Amexplan_n
AmexSimple Quote/Cuota Simpleplan_ahora
MastercardIssuer Plan/Plan Emisorplan_emisor
MastercardSimple Quote/Cuota Simpleplan_ahora
MastercardGetnet Integral/Cuota a Cuotaplan_getnet_integral
NaranjaIssuer Plan/Plan Emisorpago_en_cuota
NaranjaPlan Z(not supported)
VisaIssuer Plan/Plan Emisorplan_emisor_accelerated
VisaSimple Quote/Cuota Simpleplan_ahora
VisaGetnet Integral/Cuota a Cuotaplan_getnet_integral

Cuotas en Brasil

Para Brasil, existen dos tipos principales de opciones de pago a cuotas ofrecidas a nivel nacional:

  • Planes del emisor (Parcelado Emissor): El comercio liquidará (Settlement) la transacción una sola vez y el titular de la tarjeta pagará el importe total y las tasas correspondientes aplicadas a posteriori.
  • Cuotas del comercio (Parcelado Lojista): El comercio liquidará (Settlement) las transacciones a cuotas mes a mes (D+30), incluyendo las tasas de MDR y de descuento, y el titular de la tarjeta pagará el importe sin tasas de interés.

A continuación se muestran los posibles valores de plan de la API según la marca de tarjeta en Brasil

Marca de tarjeta disponibleNombre del planClave del plan (Schema)
AmexIssuer Planwith_interest
AmexMerchant Installmentno_interest
Elo--
MastercardIssuer Planwith_interest
MastercardMerchant Installmentno_interest
VisaIssuer Planwith_interest
VisaMerchant Installmentno_interest

Cuotas en Chile

Para Chile, existen dos tipos principales de opciones de pago a cuotas ofrecidas a nivel nacional:

  • Planes del emisor (Issuer plans): Los planes base de cuotas son ofrecidos por el emisor/bancos, con opciones que van de 2 a 48. El comercio liquidará la transacción una sola vez y el titular de la tarjeta pagará el importe total y las tasas correspondientes aplicadas a posteriori.
  • Cuotas del comercio (Cuota Comercio): Plan sin tasas ofrecido por el comercio con opciones que van de 2 a 12. El comercio liquidará la transacción en múltiples ocasiones, en función del plan seleccionado.

A continuación se muestran los posibles valores de plan de la API según la marca de tarjeta en Chile

Marca de tarjeta disponibleNombre del planClave del plan (Schema)
MastercardIssuer Plan/Plan Emisorplan_emisor
MastercardCuota Comerciocuota_comercio
VisaIssuer Plan/Plan Emisorplan_emisor
VisaCuota Comerciocuota_comercio

Cuotas en Colombia

Para Colombia, existe un tipo de opción de pago a cuotas ofrecida a nivel nacional:

  • Planes del emisor (Issuer plans): El comercio liquidará la transacción una sola vez y el titular de la tarjeta pagará el importe total y las tasas correspondientes aplicadas a posteriori.

A continuación se muestran los posibles valores de plan de la API según la marca de tarjeta en Colombia

Marca de tarjeta disponibleNombre del planClave del plan (Schema)
MastercardIssuer Planno_interest
VisaIssuer Planno_interest

Cuotas en México

Para México, solo se ofrece un tipo de opción de pago a cuotas a nivel nacional y, para que esté disponible para el comercio, requiere activarse y contratarse durante el proceso de onboarding:

  • MSI (Meses sin interés): Los planes base de cuotas son ofrecidos por PROSA, en los que el banco personal del cliente es el responsable de cobrar los pagos, mientras que el comercio recibirá una liquidación (Settlement) única que incluye las tasas de deducción.

A continuación se muestran los posibles valores de plan de la API según la marca de tarjeta en México

Marca de tarjeta disponibleNombre del planClave del plan (Schema)
Amex-no_interest
Carnet-no_interest
MastercardProsa Planno_interest
VisaProsa Planno_interest

Cuotas en Uruguay

Para Uruguay, existen dos tipos principales de opciones de pago a cuotas ofrecidas a nivel nacional:

Sin Recargo: Puede vender (o comprar) en hasta 6 cuotas sin ningún coste adicional añadido al precio final. El comercio generalmente absorbe el coste estándar de financiación dentro de su tasa de servicio, de modo que el cliente paga el “Precio al contado” (Cash Price) dividido por el número de meses. Con Recargo: Para planes más largos, se aplica un coeficiente de recargo al importe total de la venta. Si usted es un comercio, debe multiplicar el importe de la venta por un factor específico (coeficiente) antes de procesar la tarjeta.

A continuación se muestran los posibles valores de plan de la API según la marca de tarjeta en Uruguay

Marca de tarjeta disponibleNombre del planClave del plan (Schema)
Mastercar-plan_al_eje
Visa-plan_al_eje
OCA - Mastercard-plan_al_eje

Cuotas en España

Para España, solo existe un tipo de opción de pago a cuotas ofrecida a nivel nacional y, para que esté disponible para el comercio, es necesario asegurarse de que su terminal Getnet tenga activado el servicio Plazox.

  • Plazox: Para procesar transacciones a cuotas en España, se utiliza Plazox, una solución de pago que permite a los clientes fraccionar sus compras con tarjeta de crédito en 3, 6, 9 o 12 meses, tanto en tiendas físicas como online. La experiencia es sencilla y no requiere formalidades adicionales: en tienda física, el propio terminal ofrece la opción de elegir el número de cuotas tras insertar la tarjeta y el PIN, mientras que online la selección se realiza en el checkout con un solo clic. Para los comercios, la operación no supone costes ni riesgos, ya que reciben el importe íntegro de la venta de forma inmediata, mientras que el banco emisor asume la financiación del cliente. Plazox se habilita automáticamente para las tarjetas elegibles y se aplica a compras a partir de un importe mínimo de 60 euros, con la posibilidad de elevar este umbral hasta los 500 euros según los acuerdos comerciales. Es un mecanismo respaldado por la banca española que asegura fluidez, sencillez y confianza tanto para el cliente como para el comercio.

A continuación se muestran los posibles valores de plan de la API según la marca de tarjeta en España

Marca de tarjeta disponibleNombre del planClave del plan (Schema)
Amex-PLAZOX
Mastercard-PLAZOX
Visa-PLAZOX