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`

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).

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`)	✅	✅	❌

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.

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:

"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):

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

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

{
  "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):

{
  "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 para obter detalhes sobre a configuração DUKPT.