Requisitos regionales para Tarjeta Presente

La Getnet Regional API admite transacciones Tarjeta Presente en varios países de América Latina. Aunque la estructura de la API está unificada, cada país tiene requisitos específicos en cuanto a moneda, planes de cuotas y cumplimiento normativo. Este documento describe las variaciones regionales que debe tener en cuenta en su integración.

Regiones soportadas

Las transacciones Tarjeta Presente están disponibles en los siguientes países:

País	Código ISO	Moneda	Código de moneda
Chile	CL	Peso chileno	`CLP`
Argentina	AR	Peso argentino	`ARS`
México	MX	Peso mexicano	`MXN`

El campo currency de la solicitud a la API debe utilizar siempre el código alfabético ISO 4217 (CLP, ARS). El campo amount se expresa siempre en la unidad monetaria más pequeña (céntimos).

Disponibilidad de funciones por país

No todas las funciones de Tarjeta Presente están disponibles en todos los países. Utilice la siguiente tabla para determinar qué debe admitir su integración por región:

Función	Chile	Argentina	México
Chip + PIN (`online_pin`)	✅	✅	✅
Chip (Sin CVM) (`no_cvm`)	✅	✅	✅
Contactless (NFC)	✅	✅	✅
Banda magnética	✅	✅	✅
Cuotas	✅	✅	✅
Cuotas de pago (Quotes) (`/v2/payments/quotes`)	✅	✅	❌

El punto de enlace de cuotas de pago (POST /v2/payments/quotes) solo está disponible para Argentina y Chile. Los comercios en México deben utilizar planes de cuotas prenegociados sin consultar cuotas dinámicas.

Requisitos de moneda

El campo data.currency es obligatorio para todas las solicitudes de pago Tarjeta Presente. Utilice siempre el código alfabético ISO 4217 correspondiente al país donde está registrado el terminal:

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

Valores aceptados: ARS, CLP, USD, EUR, MXN.

Planes de cuotas por país

El comportamiento de las cuotas varía significativamente según el país. El schema y el type del plan devueltos por el punto de enlace de cuotas (o preconfigurados en su integración) determinan cómo liquidará la transacción la red de tarjetas.

Argentina

Argentina utiliza el programa de cuotas Plan Ahora, patrocinado por el gobierno.

Schema	Type	Descripción
`plan_ahora`	`no_interest`	Plan financiado por el comercio sin intereses para el cliente.
`plan_emisor`	`with_interest`	Plan financiado por el emisor en el que el cliente paga intereses.

Ejemplo de solicitud de cuotas (Argentina):

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

Ejemplo de respuesta de cuotas (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

Chile utiliza planes de cuotas gestionados por el emisor (plan_emisor).

Schema	Type	Descripción
`plan_emisor`	`no_interest`	Plan financiado por el emisor sin intereses para el cliente.
`plan_emisor`	`with_interest`	Plan financiado por el emisor en el que el cliente paga intereses.

Ejemplo de respuesta de cuotas (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

México no admite el punto de enlace dinámico de cuotas de pago. Utilice el campo transaction_type directamente en la solicitud de pago:

`transaction_type`	Descripción
`FULL`	Pago único, sin cuotas.
`INSTALL_NO_INTEREST`	Cuotas financiadas por el comercio (sin intereses para el cliente).
`INSTALL_WITH_INTEREST`	Cuotas financiadas por el emisor (el cliente paga intereses).

Requisitos de validación de PIN por país

La validación de PIN Online es obligatoria en algunos países para determinados tipos de transacciones. Asegúrese de que su terminal esté configurado correctamente:

País	PIN Online obligatorio	Notas
Chile	Sí (Chip)	Obligatorio para todas las transacciones con chip.
Argentina	Sí (Chip)	Obligatorio para todas las transacciones con chip.
México	Sí (Chip)	Obligatorio para todas las transacciones con chip.

Cuando se requiere online_pin, los campos pin_block y ksn son obligatorios en la solicitud. Consulte el documento Requisitos del terminal para conocer los detalles de configuración de DUKPT.

Leer más

Requisitos del terminal: Requisitos de hardware y configuración de la API para Tarjeta Presente.
Modos de entrada de tarjeta: Desglose detallado de chip, chip_contactless y magnetic_strip.
Guía de pagos a plazos: Guía paso a paso para procesar transacciones a plazos.
Visión General de Tarjeta Presente: Introducción al ecosistema de hardware de SEP.