pinpad ingenico ipp320

Título: No.:

SUC-ING-001

Versión: 1.00

Pinpad Ingenico

Fecha: 21-Nov-2012 Diseño de aplicación Pag.: 1 / 14

Documento 001 Este documento y la información contenida en él son propiedad de Ingenico. Prohibida su reproducción y difusión parcial o total, por cualquier medio sin autorización previa y por escrito de Ingenico.

Pinpad Ingenico

Título: No.:

SUC-ING-001

Versión: 1.00S

Pinpad Ingenico



CONTENIDO Pág. 1 Formato de mensajes y campos de datos 3

2 Protocolo de comunicación 4

3 Carga de Working key 5

4 Alta de NIP 6

5 Cambio de NIP 10

Título: No.:

SUC-ING-001

Versión: 1.00S

Pinpad Ingenico



1 Formato de mensajes y campos de datos Para validar la correcta transmisión de los mensajes en la línea de transmisión o el cable serial, se define una forma de encapsular cada mensaje de forma que pueda ser validado por el receptor del mismo. Una vez ensamblado cada mensaje, este antes de ser enviado se formateará de la siguiente manera:

(*) Se calcula incluyendo el ETX y excluyendo el STX. (**) El formato específico de cada campo que conforman los datos puede ser alguno de los siguientes

tipos definidos en la siguiente tabla:

Campo Longitud Formato Descripción Valor

STX 1 Byte Bin Inicio de mensaje 02h

Tipo Mensaje 3 Bytes AN identificador del mensaje “IC0”, “IC1”, …

Longitud 2 bytes Bin Longitud en bytes de los datos del mensaje.

00 9F

Datos Variable Bin** Información del mensaje. “Ins/Deslice Tarjeta”

ETX 1 Byte Bin Fin del mensaje 03h

LRC 1 Byte Bin Resultado de Longitudinal redundancy check (*).

Tipo Descripción / Ejemplos Relleno para valores menores a la longitud

máxima (padeo)

AN Alfanumérico: Caracteres ASCII imprimibles (sin bytes de control). Ejemplos: “IC0”, “DSP”, “Inserte tarjeta”

Espacios a la derecha o izquierda.

BCD Binario codificado en decimal: Valor numérico (solo dígitos decimales), cada par de dígitos conforman un byte. Ejemplos: 04 84, 00 00 00 12 00 00

Ceros a la izquierda

HEX Hexadecimal: Valor expresado en hexadecimal (0-F), dos dígitos conforman un byte. Ejemplos: E8 F3, 02 F4

Ceros a la izquierda

Bin Binario: Al menos se tiene un byte conformado por 8 bits donde cada bit activa o desactiva una función. El bit menos significativo de denota como b0 y el más significativo como b7. En algunos casos se usa el valor binario para configurar un parámetro con su equivalente decimal. Ejemplo: 03 (00000011: b0=1,b1=1, b2=b3=b4=b5=b6=b7=0) Ejemplo: 3C (60 decimal, para configurar un tiempo de 60 seg)

Ceros en el resto de bits

Título: No.:

SUC-ING-001

Versión: 1.00

Pinpad Ingenico



2 Protocolo de comunicación De igual forma, para sincronizar los puertos de ambos dispositivos, se utilizará comunicación asíncrona para el intercambio de mensajes entre el pinpad y la caja con la siguiente configuración por default:

19200,N,8,1 Donde: Velocidad: 19200 bps Paridad: Ninguna Bits de datos: 8 Bits de parada: 1 Cada mensaje transmitido o recibido, además de cumplir con el formato definido en el punto 2 debe ser confirmada su recepción con un ACK (06h) cuando el LRC recibido coincide con el calculado por el dispositivo receptor o notificar el error en el LRC a través de un NAK (15h) para que se retransmita.

Título: No.:

SUC-ING-001

Versión: 1.00

Pinpad Ingenico



3 Carga Working Key Pc �� Para hacer la carga de la Working Key se tiene que enviar un comando de Tipo LWK con el siguiente formato.

STX Comando

Tipo- Long (bytes)

Llave ETX LRC

02

LWK 4C 57 4B

HEX(8/16) 00 10

Llave que se cargara B0 54 82 2F A3 3B 53 C2 3F D2 34 69 D3 C5 B1 A6

03

B2

Este es el ejemplo de carga de llave: 02 4C 57 4B 00 10 B0 54 82 2F A3 3B 53 C2 3F D2 34 69 D3 C5 B1 A6 03 B2

Pin Pad �� EL Pin Pad envia la respuesta de la carga de llave

ACK STX Comando Tipo-

Long (bytes) Respuesta ETX LRC

06

02

LWK 4C 57 4B

HEX(8/16) 00 01

00

03

B2

06 02 4C 57 4B 00 01 00 03 52

Título: No.:

SUC-ING-001

Versión: 1.00S

Pinpad Ingenico



4 Alta de Pin Pc �� Para dar de alta el PIN primero se solicita la lectura de tarjeta.

STX Comando Tipo-

Long (bytes) Mensaje ETX LRC

02

IC0 49 43 30

HEX(8/16) 00 0A

Mensaje que mostrara en el display (LEER

BANDA)

4C 45 45 52 20 42 41 4E 44 41

03

45

Este es el ejemplo del mensaje de lectura de Banda: 02 49 43 30 00 0A 4C 45 45 52 20 42 41 4E 44 41 03 45

Pin Pad ��

- Retorna información de la transacción iniciada

Campo Descripción Tipo- Long (bytes)

Ejemplo

1 Status de la operación BCD(1) 00 Sin error 06 Información recuperada por banda magnética 99 Error desconocido

5 Track2Data El primer byte es la longitud

HEX(21) 06 13 47 37 01 18 34 66 40 46 D1 30 52 01 00 00 00 22 00 00 0F FF

6 Track 1 Data El primer byte es la longitud

AN(81) 43 42 34 37 33 37 30 31 31 38 33 34 36 36 34 30 34 36 5E 41 42 52 41 48 41 4D 20 44 45 20 4C 41 20 43 52 55 5A 20 52 20 5E 31 33 30 35 32 30 31 30 30 30 30 30 30 30 30 30 30 30 30 32 32 30 30 30 30 30 30 00 00 00 00 00 00 00 00 00 00 00 00 00

06 02 49 43 30 00 67 06 13 47 37 01 18 34 66 40 46 D1 30 52 01 00 00 00 22 00 00 0F FF 43 42 34 37 33 37 30 31 31 38 33 34 36 36 34 30 34 36 5E 41 42 52 41 48 41 4D 20 44 45 20 4C 41 20 43 52 55 5A 20 52 20 5E 31 33 30 35 32 30 31 30 30 30 30 30 30 30 30 30 30 30 30 32 32 30 30 30 30 30 30 00 00 00 00 00 00 00 00 00 00 00 00 00 03 19

Título: No.:

SUC-ING-001

Versión: 1.00S

Pinpad Ingenico



Pc �� MENSAJE INGRESAR NUEVO PIN PIN (request) – Solicita la captura del nuevo PIN y genera el correspondiente Pinblock de acuerdo a las siguientes condiciones:

• Cargar previamente el juego de llaves MKey y WKey. Esta carga será en la posición 0 del pinpad.

• El mensaje más reciente recibido en el pinpad debe corresponder a un comando IC0 que haya recuperado los datos de la lectura de banda sin error o un mensaje PIN para una recaptura.

STX Comando

Tipo- Long (bytes)

Mensaje ETX LRC

02

PIN 50 49 4E

HEX(8/16) 00 0A

Mensaje que mostrara en el display ( INGRESE NUEVO PIN) 49 4E 47 52 45 53 45 20 4E 55 45 56 4F 20 50 49 4E

03

14

01 50 49 4E 00 11 49 4E 47 52 45 53 45 20 4E 55 45 56 4F 20 50 49 4E 03 14

MENSAJE PIN (answer) – Retorna el Pinblock de la captura de PIN efectuada con base a los datos de lectura de banda recuperados del comando IC0 anterior.


Ejemplo

1 Status de operación BCD(1) 00 PIN capturado 03 Operación cancelada

11 Falta cargar llave para cifrado de PIN 12 No se capturó PIN 13 Error en modulo de seguridad 14 Tiempo de captura excedido 16 Error en secuencia (mensaje anterior distinto a IC0/PIN)

2 Pinblock generado HEX(8) 18 8F AF FA EF 9C 6F B1

Ejemplo:

06 02 50 49 4E 00 09 00 18 8F AF FA EF 9C 6F B1 03 32

Título: No.:

SUC-ING-001

Versión: 1.00S

Pinpad Ingenico



Pc ��

• MENSAJE CONFIRMAR PIN (request) – Solicita nuevamente la captura de PIN.

STX Comando

Tipo- Long (bytes)

Mensaje ETX LRC

02

PIN 50 49 4E

HEX(8/16) 00 0D

Mensaje que mostrara en el display (CONFIRMAR PIN) 00 0D 43 4F 4E 46 49 52 4D 41 52 20 50 49 4E

03

6F

02 50 49 4E 00 0D 43 4F 4E 46 49 52 4D 41 52 20 50 49 4E 03 6F



Ejemplo




Ejemplo:

06 02 50 49 4E 00 09 00 F4 57 10 6C F5 FC 8B 6B 03 6B

Título: No.:

SUC-ING-001

Versión: 1.00S

Pinpad Ingenico



Título: No.:

SUC-ING-001

Versión: 1.00S

Pinpad Ingenico



5 Cambio de Pin Pc �� Para hacer cambio de el PIN primero se solicita la lectura de tarjeta.

STX Comando

Tipo- Long (bytes)

Mensaje ETX LRC

02

IC0 49 43 30

HEX(8/16) 00 0A

Mensaje que mostrara en el display (LEER BANDA)

4C 45 45 52 20 42 41 4E 44 41

03

45

Este es el ejemplo del mensaje de lectura de Banda: 02 49 43 30 00 0A 4C 45 45 52 20 42 41 4E 44 41 03 45

Pin Pad ��

- Retorna información de la transacción iniciada


Ejemplo

1 Status de la operación BCD(1) 03 Sin error 06 Información recuperada por banda magnética 99 Error desconocido

5 Track2Data El primer byte es la longitud

HEX(21) 06 13 47 37 01 18 34 66 40 46 D1 30 52 01 00 00 00 22 00 00 0F FF

6 Track 1 Data El primer byte es la longitud

AN(81) 43 42 34 37 33 37 30 31 31 38 33 34 36 36 34 30 34 36 5E 41 42 52 41 48 41 4D 20 44 45 20 4C 41 20 43 52 55 5A 20 52 20 5E 31 33 30 35 32 30 31 30 30 30 30 30 30 30 30 30 30 30 30 32 32 30 30 30 30 30 30 00 00 00 00 00 00 00 00 00 00 00 00 00

06 02 49 43 30 00 67 06 13 47 37 01 18 34 66 40 46 D1 30 52 01 00 00 00 22 00 00 0F FF 43 42 34 37 33 37 30 31 31 38 33 34 36 36 34 30 34 36 5E 41 42 52 41 48 41 4D 20 44 45 20 4C 41 20 43 52 55 5A 20 52 20 5E 31 33 30 35 32 30 31 30 30 30 30 30 30 30 30 30 30 30 30 32 32 30 30 30 30 30 30 00 00 00 00 00 00 00 00 00 00 00 00 00 03 19

Título: No.:

SUC-ING-001

Versión: 1.00S

Pinpad Ingenico



Pc �� MENSAJE SOLICITAR PIN (request) – Solicita la captura de PIN y genera el correspondiente Pinblock de acuerdo a las siguientes condiciones:

• Cargar previamente el juego de llaves MKey y WKey. Esta carga será en la posición 0 del pinpad.

• El mensaje más reciente recibido en el pinpad debe corresponder a un comando IC0 que haya recuperado los datos de la lectura de banda sin error o un mensaje PIN para una recaptura.

STX Comando

Tipo- Long (bytes)

Mensaje ETX LRC

02

PIN 50 49 4E

HEX(8/16) 00 0A

Mensaje que mostrara en el display (INGRESE PIN) 49 4E 47 52 45 53 45 20 50 49 4E

03

45

02 50 49 4E 00 0A 49 4E 47 52 45 53 45 20 50 49 4E 03 45



Ejemplo




Ejemplo:

06 02 50 49 4E 00 09 00 18 8F AF FA EF 9C 6F B1 03 32

Título: No.:

SUC-ING-001

Versión: 1.00S

Pinpad Ingenico



Pc ��

• MENSAJE INGRESE NUEVO PIN (request) – Solicita la captura del nuevo PIN.

STX Comando

Tipo- Long (bytes)

Mensaje ETX LRC

02

PIN 50 49 4E

HEX(8/16) 00 11

Mensaje que mostrara en el display (INGRESE NUEVO PIN) 49 4E 47 52 45 53 45 20 4E 55 45 56 4F 20 50 49 4E

03

14

02 50 49 4E 00 11 49 4E 47 52 45 53 45 20 4E 55 45 56 4F 20 50 49 4E 03 14



Ejemplo




Ejemplo:

06 02 50 49 4E 00 09 00 F4 57 10 6C F5 FC 8B 6B 03 6B

Título: No.:

SUC-ING-001

Versión: 1.00S

Pinpad Ingenico



Pc ��

• MENSAJE CONFIRMAR PIN (request) – Solicita nuevamente la captura de PIN.

STX Comando

Tipo- Long (bytes)

Mensaje ETX LRC

02

PIN 50 49 4E

HEX(8/16) 00 0D

Mensaje que mostrara en el display (CONFIRMAR PIN) 00 0D 43 4F 4E 46 49 52 4D 41 52 20 50 49 4E

03

6F

02 50 49 4E 00 0D 43 4F 4E 46 49 52 4D 41 52 20 50 49 4E 03 6F



Ejemplo




Ejemplo:

06 02 50 49 4E 00 09 00 F4 57 10 6C F5 FC 8B 6B 03 6B

Título: No.:

SUC-ING-001

Versión: 1.00S

Pinpad Ingenico



pinpad ingenico ipp320

Documents