# Installments

This feature divides the total price into smaller, equal payments made over an agreed period, instead of single upfront payment. This method is widely used in LATAM markets and lets customers choose a payment schedule instead of paying the full amount at once, but its implementation depends on card support availability and must comply with regional regulations.

Below are the available card brands that support installments in each country

| Available Card Scheme | Argentina | Brazil | Chile | Mexico | Spain | Uruguay |
| :-------------------: | :-------: | :----: | :---: | :----: | :---: | :-----: |
|          Amex         |     ✅    |   ✅   |   ✅  |   ✅   |   -   |    -    |
|         Cabal         |     ✅    |    -   |   -   |    -   |   -   |    -    |
|         Carnet        |     -     |    -   |   -   |   ✅   |   -   |    -    |
|          Elo          |     -     |   ✅   |   -   |    -   |   -   |    -    |
|       Mastercard      |     ✅    |   ✅   |   ✅  |   ✅   |   -   |   ✅    |
|        Naranja        |     ✅    |    -   |   -   |    -   |   -   |    -    |
|          Visa         |     ✅    |   ✅   |   ✅  |   ✅   |   -   |   ✅    |

## Available Countries

The following tables show by country the types of installments options offered. Consult them to check the installments offered by your country.

### Argentina Installments

For Argentina there are two main types of installments options offered at country level, and can only be processed with national or domestic cards:

* **Issuer plans:** Base installment plans are offered by the Issuer/Banks.
* **Government plans (Cuota Simple / Plan Ahora):** Option offered by the Argentinian government usually at lower interest fees than the Issuer plan.

Below are the possible API plan values by card brand in Argentina

| Available Card Scheme |         Plan Name         |     Plan Key (Schema)     |
| :-------------------: | :-----------------------: | :-----------------------: |
|          Amex         |   Issuer Plan/Plan Emisor |          `plan_n`         |
|          Amex         | Simple Quote/Cuota Simple |        `plan_ahora`       |
|          Cabal        |  Issuer Plan/Plan Emisor  |      `plan_emissor`       |
|       Mastercard      |  Issuer Plan/Plan Emisor  |       `plan_emisor`       |
|       Mastercard      | Simple Quote/Cuota Simple |        `plan_ahora`       |
|       Mastercard      |    Plan Getnet Simple     |    `plan_getnet_simple`   |
|        Naranja        |  Issuer Plan/Plan Emisor  |      `pago_en_cuota`      |
|          Visa         |  Issuer Plan/Plan Emisor  | `plan_emisor_accelerated` |
|          Visa         | Simple Quote/Cuota Simple |        `plan_ahora`       |

### Brazil Installments

For Brazil there are one main type of installments options offered at country level:

* **Merchant installments (Parcelado Lojista):** The merchant will settle the installments transactions month by month (D+30) including MDR and discount fees, and the cardholder will pay the amount without any interest fees. **The seller covers the interest**.

Below are the possible API plan values by card brand in Brazil

| Available Card Scheme |   Plan Name   | Plan Key (Schema)  |
| :-------------------: | :-----------: | :----------------: |
|          Amex         | Plano Lojista |   `plan_lojista`   |
|          Elo          | Plano Lojista |   `plan_lojista`   |
|       Mastercard      | Plano Lojista |   `plan_lojista`   |
|          Visa         | Plano Lojista |   `plan_lojista`   |
|       Hipercard       | Plano Lojista |   `plan_lojista`   |

### Chile Installments

For Chile there are two main types of installments options offered at country level:

* **Issuer plans:** Base installment plans are offered by the Issuer/Banks with options that come within a range from 2 to 48. The merchant will settle the transaction only once and the cardholder will pay the total amount and any corresponding fees applied afterwards.
* **Merchant installments (Cuota Comercio):** No fees plan offered by the merchant with options that come within a range from 2 to 12. The merchant will settle the transaction multiple times, depending on the selected plan.

Below are the possible API plan values by card brand in Chile

| Available Card Scheme |        Plan Name        | Plan Key (Schema) |
| :-------------------: | :---------------------: | :---------------: |
|          Amex         |      Cuotas Emisor      |   `plan_emisor`   |
|       Mastercard      |      Cuotas Emisor      |   `plan_emisor`   |
|       Mastercard      |      Precio Contado     |  `cuota_comercio` |
|          Visa         |      Cuotas Emisor      |   `plan_emisor`   |
|          Visa         |      Precio Contado     |  `cuota_comercio` |

### Mexico Installments

For Mexico there are only one type of installments option offered at country level, and to be available for the merchant, it requires to be activated and contracted during the onboarding process:

* **MSI (Meses sin interés):** Base installment plans are offered by PROSA in which the customer's personal bank is responsible for collecting payments, while the merchant will receive a unique settlement that includes any deducting fees.

Below are the possible API plan values by card brand in Mexico

| Available Card Scheme |  Plan Name | Plan Key (Schema) |
| :-------------------: | :--------: | :---------------: |
|          Amex         | Plan Prosa |   `plan_prosa`    |
|         Carnet        | Plan Prosa |   `plan_prosa`    | 
|       Mastercard      | Plan Prosa |   `plan_prosa`    |
|          Visa         | Plan Prosa |   `plan_prosa`    |

### Uruguay Installments

For Uruguay, the installment details and any applicable fees are sent in the payment intent through the `key` field, which identifies the type of fee, for example, in Uruguay, **IVA** (Value Added Tax). The `value` field specifies the percentage rate that will be applied for that fee.

The installments available are from 2 to 24 and can only be processed in Uruguayan Pesos (UYU). Installments are not available for USD payments. 

Uruguay has the following main IVA categories:
| Category |  Percentage |
| :------: | :---------: |
| Standard | 22% |
| Reduced  | 10% |
| Exempt   | 0% |

Below are the possible API plan values by card brand in Uruguay

| Available Card Scheme |   Plan Name   | Plan Key (Schema) |
| :-------------------: | :-----------: | :---------------: |
|        Mastercard     |  Plan al Eje  |   `plan_al_eje`   |
|          Visa         |  Plan al Eje  |   `plan_al_eje`   |