ISO 8583 en palabras propias

ISO 8583 es la norma internacional que define cómo se arman los mensajes de las transacciones con tarjeta: los terminales, los switches y los bancos la usan para hablar entre sí. Esta página la explica con palabras propias y a nivel de concepto.

Lo que esta página no es

Cada red de tarjetas publica su propia especificación sobre ISO 8583, con campos privados y reglas adicionales. Esas especificaciones son material con licencia y no se reproducen aquí. Cuando un integrador necesite el detalle de una red concreta, lo toma del manual de esa red, que su banco patrocinante le entrega.

Un mensaje tiene tres partes

1. 1. Tipo de mensaje (MTI)4 dígitos: qué es este mensaje
   2. Mapa de bitsQué campos vienen, uno por bit
   3. Campos de datos (DE)Solo los que el mapa dice, en orden

Muchas implementaciones agregan delante un prefijo de longitud (dos o cuatro bytes) para que el receptor sepa dónde termina el mensaje en la conexión TCP. A eso se le llama framing, y si el emisor y el receptor no se ponen de acuerdo en él, ninguno de los dos entiende nada.

El tipo de mensaje (MTI)

Son cuatro dígitos y cada uno responde una pregunta:

Dígito	Pregunta	Ejemplos
1.º	¿Qué versión de la norma?	0 = versión de 1987, la más extendida
2.º	¿De qué clase es?	1 autorización, 2 financiero, 4 reverso, 5 conciliación, 8 gestión de red
3.º	¿Qué función cumple?	0 solicitud, 1 respuesta, 2 aviso, 3 respuesta al aviso
4.º	¿Quién lo originó?	0 el adquirente, 1 el adquirente repitiendo

Así, 0200 se lee «versión 1987, financiero, solicitud, del adquirente»: una compra que pide aprobación. 0210 es su respuesta. 0420 es «reverso, aviso»: deshaz lo que te pedí. La lista de los que usa Aurora está en Tipos de mensaje.

Una regla práctica que se cumple casi siempre: la respuesta es la solicitud más 10. 0100 → 0110, 0200 → 0210, 0800 → 0810.

El mapa de bits

Un mensaje ISO 8583 no lleva todos los campos posibles, que son 128. Lleva solo los que necesita. El mapa de bits dice cuáles: 64 bits donde un 1 en la posición 4 significa «viene el campo 4». Si el primer bit está encendido, hay un segundo mapa con los campos 65 a 128.

Por eso un campo de más o de menos no es un detalle: si el receptor cree que viene un campo que no viene, o mide mal su longitud, lee corrido todo lo que sigue.

Los campos que vas a ver siempre

Cada campo se identifica por su número: «DE 4» (data element 4). Estos son los que aparecen en casi cualquier conversación con el switch, descritos con nuestras palabras:

Campo	Qué lleva	Por qué importa
DE 2	El número de la tarjeta	Es dato sensible: nunca se guarda en claro ni se muestra completo
DE 3	El código de proceso: qué operación es (compra, retiro, consulta, devolución) y de qué cuenta	Junto con el MTI, decide qué tubería corre
DE 4	El monto de la transacción	En la moneda del DE 49, sin separador decimal
DE 7	Fecha y hora de transmisión	Ayuda a ubicar el mensaje en el tiempo
DE 11	Número de secuencia del mensaje (STAN)	Lo pone quien envía; sirve para emparejar solicitud y respuesta
DE 12 / 13	Hora y fecha local del terminal	Lo que el comercio ve en su recibo
DE 22	Cómo se leyó la tarjeta: chip, banda, sin contacto, digitada	Cambia qué validaciones aplican
DE 32	Quién adquirió la transacción	Identifica a la institución de origen
DE 35	Datos de la banda (o su equivalente del chip)	Dato sensible
DE 37	Número de referencia de la recuperación (RRN)	Con él se encuentra la original al reversar o reclamar
DE 38	Código de autorización	Lo da el emisor cuando aprueba
DE 39	Código de respuesta	00 aprobada; cualquier otro, el motivo. Ver Códigos de respuesta
DE 41 / 42	Terminal y comercio	Base de los lotes y de los totales
DE 49	Moneda	Fija cuántos decimales tiene el monto
DE 52	El PIN, cifrado	Solo el HSM lo puede abrir
DE 55	Los datos del chip (EMV), incluido el criptograma	El emisor verifica con ellos que la tarjeta es auténtica
DE 70	Código de gestión de red	En los mensajes 08xx: inicio de sesión, eco, cambio de llaves
DE 90	Datos del mensaje original	En los reversos, para encontrar qué se deshace
DE 95	Montos de reemplazo	En un reverso parcial: cuánto quedó cobrado de verdad

El monto no lleva coma

El DE 4 de una compra de 125,50 en una moneda con dos decimales viaja como 000000012550. La moneda (DE 49) dice dónde va la coma. Hay monedas con cero decimales y con tres, así que suponer siempre dos es un error clásico.

Dialectos: el mismo idioma, con acentos distintos

La norma deja muchas decisiones abiertas: si un campo numérico va en ASCII o en BCD, cuánto mide un campo variable, qué lleva cada campo privado. Cada red y cada banco toman esas decisiones a su manera. A ese conjunto de decisiones se le llama dialecto.

Aurora guarda el dialecto de cada contraparte como dato, no como código. Y mantiene dos descripciones separadas a propósito: lo que Aurora acepta por sus puertos y lo que Aurora emite hacia cada contraparte. Unificarlas parece limpieza, pero rompe: se pierden campos que solo declara una de las dos.

Un ejemplo real de lo que cuesta un dialecto mal declarado: un campo de moneda descrito como texto de tres caracteres cuando la contraparte lo enviaba como número en BCD, que ocupa dos bytes. Un byte de diferencia, y todos los campos siguientes se leyeron corridos.

Qué sigue

• Mensaje único y mensaje doble
• Autorización, reverso y aviso
• Mensajería de red: inicio de sesión, eco y llaves