# Requisitos Regionais para Cartão Presente

A **Getnet Regional API** suporta transações **Cartão Presente** em diversos países da América Latina. Embora a estrutura da API seja unificada, cada país possui requisitos específicos de moeda, planos de parcelamento e conformidade regulatória. Este documento descreve as variações regionais que você deve considerar em sua integração.

## Regiões Suportadas

As transações Cartão Presente estão disponíveis nos seguintes países:

| País | Código ISO | Moeda | Código de Moeda |
| --- | --- | --- | --- |
| **Chile** | CL | Peso Chileno | `CLP` |
| **Argentina** | AR | Peso Argentino | `ARS` |
| **México** | MX | Peso Mexicano | `MXN` |

<Callout type="note">

O campo `currency` na requisição da API deve sempre utilizar o código alfabético ISO 4217 (`CLP`, `ARS`). O campo `amount` é sempre expresso na menor unidade monetária (centavos).

</Callout>

## Disponibilidade de Recursos por País

Nem todos os recursos de Cartão Presente estão disponíveis em todos os países. Use a matriz abaixo para determinar o que sua integração deve suportar por região:

| Recurso | Chile | Argentina | México |
| --- | --- | --- | --- |
| **Chip + PIN** (`online_pin`) | ✅ | ✅ | ✅ |
| **Chip (Sem CVM)** (`no_cvm`) | ✅ | ✅ | ✅ |
| **Contactless (NFC)** | ✅ | ✅ | ✅ |
| **Tarja Magnética** | ✅ | ✅ | ✅ |
| **Parcelamento** | ✅ | ✅ | ✅ |
| **Cotações de Parcelamento** (`/v2/payments/quotes`) | ✅ | ✅ | ❌ |

<Callout type="warning">

O endpoint de cotações de parcelamento (`POST /v2/payments/quotes`) está **disponível apenas para Argentina e Chile**. Estabelecimentos comerciais no México devem usar planos de parcelamento pré-negociados sem consultar cotações dinâmicas.

</Callout>

## Requisitos de Moeda

O campo `data.currency` é obrigatório para todas as requisições de pagamento Cartão Presente. Sempre use o código alfabético ISO 4217 correspondente ao país onde o terminal está registrado:

```json
"data": {
  "amount": 30960,
  "currency": "CLP"
}
```

Valores aceitos: `ARS`, `CLP`, `USD`, `EUR`, `MXN`.

## Planos de Parcelamento por País

O comportamento do parcelamento varia significativamente por país. O `schema` e o `type` do plano retornados pelo endpoint de cotações (ou pré-configurados em sua integração) determinam como a rede do cartão liquidará a transação.

### Argentina

A Argentina utiliza o programa de parcelamento **Plan Ahora**, patrocinado pelo governo.

| Schema | Type | Descrição |
| --- | --- | --- |
| `plan_ahora` | `no_interest` | Plano financiado pelo estabelecimento sem juros para o cliente. |
| `plan_emisor` | `with_interest` | Plano financiado pelo emissor onde o cliente paga juros. |

**Exemplo de Requisição de Cotação de Parcelamento (Argentina):**

```json
{
  "amount": 12000,
  "bin": "601070000",
  "installment_type_filter": "no_interest"
}
```

**Exemplo de Resposta de Cotação (Argentina):**

```json
{
  "amount": 10000,
  "options": [
    {
      "quote_id": "06f256c8-1bbf-42bf-93b4-ce2041bfb87e",
      "schema": "plan_ahora",
      "type": "no_interest",
      "number": 2,
      "installment_amount": "5000",
      "total_amount": "10000"
    }
  ]
}
```

### Chile

O Chile utiliza planos de parcelamento gerenciados pelo emissor (`plan_emisor`).

| Schema | Type | Descrição |
| --- | --- | --- |
| `plan_emisor` | `no_interest` | Plano financiado pelo emissor sem juros para o cliente. |
| `plan_emisor` | `with_interest` | Plano financiado pelo emissor onde o cliente paga juros. |

**Exemplo de Resposta de Cotação (Chile):**

```json
{
  "amount": 10000,
  "options": [
    {
      "quote_id": "06f256c8-1bbf-42bf-93b4-ce2041bfb87e",
      "schema": "plan_emisor",
      "type": "no_interest",
      "number": 2,
      "installment_amount": "5000",
      "total_amount": "10000"
    }
  ]
}
```

### México

O México não suporta o endpoint dinâmico de cotações de parcelamento. Use o campo `transaction_type` diretamente na requisição de pagamento:

| `transaction_type` | Descrição |
| --- | --- |
| `FULL` | Pagamento à vista, sem parcelas. |
| `INSTALL_NO_INTEREST` | Parcelas financiadas pelo estabelecimento (sem juros para o cliente). |
| `INSTALL_WITH_INTEREST` | Parcelas financiadas pelo emissor (cliente paga juros). |

## Requisitos de Validação de PIN por País

A validação de PIN Online é obrigatória em certos países para tipos específicos de transação. Certifique-se de que seu terminal esteja configurado adequadamente:

| País | PIN Online Obrigatório | Notas |
| --- | --- | --- |
| **Chile** | Sim (Chip) | Obrigatório para todas as transações com chip. |
| **Argentina** | Sim (Chip) | Obrigatório para todas as transações com chip. |
| **México** | Sim (Chip) | Obrigatório para todas as transações com chip. |

Quando `online_pin` é exigido, os campos `pin_block` e `ksn` são obrigatórios na requisição. Consulte o documento [Requisitos do Terminal](/pt/global-api/reference-global/terminal-requirements) para obter detalhes sobre a configuração DUKPT.

## Leia Mais

- **[Requisitos do Terminal](/pt/global-api/reference-global/terminal-requirements)**: Requisitos de hardware e configuração de API para Cartão Presente.
- **Modos de Entrada do Cartão**: Detalhamento de `chip`, `chip_contactless` e `magnetic_stripe`.
- **Guia de Pagamentos Parcelados**: Guia passo a passo para processar transações parceladas.
- **Visão Geral do Cartão Presente**: Introdução ao ecossistema de hardware SEP.