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 disponible | Argentina | Brasil | Chile | México | Uruguay | España | Colombia | Portugal |
|---|---|---|---|---|---|---|---|---|
| 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:
| Atributo | Tipo | Descripción | Ejemplo |
|---|---|---|---|
amount | integer | Importe total a pagar | 8900 |
bin | string | Primeros 6 o 9 dígitos de la tarjeta* | 123412 |
installment_type_filter | string | Propiedad opcional que solo puede tener dos valores posibles | no_interest o with_interest |
number_token | string | Token de la tarjeta que se utilizará en las transacciones | dfe05208b105578c070f806c80abd3a |
*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.
| Atributo | Tipo | Descripción | Ejemplo |
|---|---|---|---|
quote_id | string | Quote ID a utilizar en la consulta | 06f256c8-1bbf-42bf-93b4-ce2041bfb87e |
schema | string | Código que agrupa los créditos por categoría | plan_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_typedebe establecerse como “INSTALL_NO_INTEREST”. Aunque otros valores comoFULLeINSTALL_WITH_INTERESTson compatibles en otros mercados, soloINSTALL_NO_INTERESTes válido para Uruguay.- Los valores posibles de
number_installmentsvan 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 comoplan_al_eje.type: este valor es siempre fijo comono_interest.
España
transaction_typedebe 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_installmentsson 3, 6, 9 y 12. schema: este valor es siempre fijo comoPLAZOX.type: este valor es siempre fijo comono_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, elquote_iddebe generarse bajono_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_iddebe generarse bajowith_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 disponible | Nombre del plan | Clave del plan (Schema) |
|---|---|---|
| Amex | Plan de Cuotas Amex | plan_n |
| Amex | Simple Quote/Cuota Simple | plan_ahora |
| Mastercard | Issuer Plan/Plan Emisor | plan_emisor |
| Mastercard | Simple Quote/Cuota Simple | plan_ahora |
| Mastercard | Getnet Integral/Cuota a Cuota | plan_getnet_integral |
| Naranja | Issuer Plan/Plan Emisor | pago_en_cuota |
| Naranja | Plan Z | (not supported) |
| Visa | Issuer Plan/Plan Emisor | plan_emisor_accelerated |
| Visa | Simple Quote/Cuota Simple | plan_ahora |
| Visa | Getnet Integral/Cuota a Cuota | plan_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 disponible | Nombre del plan | Clave del plan (Schema) |
|---|---|---|
| Amex | Issuer Plan | with_interest |
| Amex | Merchant Installment | no_interest |
| Elo | - | - |
| Mastercard | Issuer Plan | with_interest |
| Mastercard | Merchant Installment | no_interest |
| Visa | Issuer Plan | with_interest |
| Visa | Merchant Installment | no_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 disponible | Nombre del plan | Clave del plan (Schema) |
|---|---|---|
| Mastercard | Issuer Plan/Plan Emisor | plan_emisor |
| Mastercard | Cuota Comercio | cuota_comercio |
| Visa | Issuer Plan/Plan Emisor | plan_emisor |
| Visa | Cuota Comercio | cuota_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 disponible | Nombre del plan | Clave del plan (Schema) |
|---|---|---|
| Mastercard | Issuer Plan | no_interest |
| Visa | Issuer Plan | no_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 disponible | Nombre del plan | Clave del plan (Schema) |
|---|---|---|
| Amex | - | no_interest |
| Carnet | - | no_interest |
| Mastercard | Prosa Plan | no_interest |
| Visa | Prosa Plan | no_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 disponible | Nombre del plan | Clave 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 disponible | Nombre del plan | Clave del plan (Schema) |
|---|---|---|
| Amex | - | PLAZOX |
| Mastercard | - | PLAZOX |
| Visa | - | PLAZOX |