manual de integración pos intergrado (Último)

MANUAL DE DESARROLLO POS INTEGRADO

Manual Integracin

POS Integrado Versin 2.2

Pgina 2

Contenido

CONTROL DE CAMBIOS ................................................................................................................................ 4

1. OBJETIVO ............................................................................................................................................. 6

2. REQUERIMIENTOS DE HARDWARE ....................................................................................................... 6

3. TRANSACCIONES SOPORTADAS............................................................................................................ 7

3.1 TRANSACCIN DE VENTA ................................................................................................................................. 7

3.2 TRANSACCIN LTIMA VENTA ......................................................................................................................... 8

3.3 TRANSACCIN ANULACIN VENTA .................................................................................................................... 8

3.4 TRANSACCIN DE CIERRE. ............................................................................................................................... 9

3.5 TRANSACCIN DETALLE DE VENTAS ................................................................................................................... 9

3.6 TRANSACCIN TOTALES .................................................................................................................................. 9

3.7 TRANSACCIN CARGA DE LLAVES ...................................................................................................................... 9

3.8 TRANSACCIN DE POOLING............................................................................................................................ 10

3.9 CAMBIO DE MODALIDAD A POS NORMAL ........................................................................................................ 10

4. DIAGRAMAS DE SECUENCIA ............................................................................................................... 10

4.1 VENTA ....................................................................................................................................................... 10

4.2 LTIMA VENTA ........................................................................................................................................... 11

4.3 ANULACIN ................................................................................................................................................ 12

4.4 CIERRE ....................................................................................................................................................... 13

4.5 CARGA DE LLAVES ........................................................................................................................................ 14

4.6 POOLING .................................................................................................................................................... 15

5. ESPECIFICACIN DE PROTOCOLO DE COMUNICACIN CAJA - POS ..................................................... 15

5.1 ESQUEMA DE COMUNICACIN CAJA - POS ....................................................................................................... 15

5.2 FLUJO DE LA COMUNICACIN CAJA - POS ........................................................................................................ 16

6. MENSAJERA DE COMANDOS ............................................................................................................. 16

CONSIDERACIONES GENERALES DE MENSAJERA ...................................................................................................... 16

6.1 VENTA ....................................................................................................................................................... 17

Manual Integracin


Pgina 3

6.2 LTIMA VENTA ........................................................................................................................................... 19

6.3 ANULACIN ................................................................................................................................................ 21

6.4 CIERRE ....................................................................................................................................................... 22

6.5 DETALLE DE VENTAS ..................................................................................................................................... 23

6.6 TOTALES .................................................................................................................................................... 26

6.7 CARGA DE LLAVES ........................................................................................................................................ 27

6.8 POOLING .................................................................................................................................................... 28

6.9 CAMBIO DE MODALIDAD A POS NORMAL ........................................................................................................ 28

7. VOUCHER ........................................................................................................................................... 29

8. FLUJOS DE VENTA Y OTROS ................................................................................................................ 30

8.1 FLUJO TX 3.20 CON BOLETA, PROPINA, EMPLEADO ............................................................................................ 30

8.2 FLUJO TX 3.20 SIN BOLETA, PROPINA, EMPLEADO .............................................................................................. 30

8.4 FLUJO TX 3.40 SIN BOLETA, PROPINA, EMPLEADO .............................................................................................. 32

8.6 CAMBIO DE MODALIDAD POS INTEGRADO A POS NORMAL ................................................................................. 33

9. TIPOS DE CONEXIN A POS ................................................................................................................ 34

9.1 CONEXIN POS CON CABLE SERIAL ................................................................................................................. 34

9.2 CONEXIN POS CON CABLE LAN PARA COMUNICACIN CON TRANSBANK .............................................................. 35

9.3 CONEXIN POS CON CABLE TELEFNICO PARA COMUNICACIN CON TRANSBANK ................................................ 36

10. TABLA ABREVIACIN DE TARJETAS ................................................................................................. 37

11. TABLA DE RESPUESTAS ................................................................................................................... 38

12. ANEXO 1 ......................................................................................................................................... 39

13. ANEXO 2: DETALLE CAMPOS DE CADA TRANSACCIN .................................................................... 42

Manual Integracin


Pgina 4

Control de Cambios

Versin Cambio Responsable Fecha

1.1 Manual original de equipo VX-700. Andrs

Villalobos

Oct-2011

1.2 Se incorpora funcionalidad de Cuadratura. Andrs

Villalobos

Feb-2012

1.3 Se modifica tabla con funciones del POS

Se incorpora informacin de seguridad a peticin de H&M.

Andrs

Villalobos

Mar-2012

1.4 Se incorpora la explicacin de las variables que utilizan los

comandos.

Andrs

Villalobos

Abr-2012

1.5 Se actualiza el flujo cambio de modalidad POS Integrado.

Se incorpora tabla con abreviacin de tarjetas a peticin de

pticas Schilling.

Se elimina la opcin de envo de mensajes intermedios.

Andrs

Villalobos

Jun-2012

1.6 Se elimina la opcin de enviar Cuotas en una transaccin

de venta.

Se elimina la opcin de enviar el voucher pintado para las

transacciones de POS Integrado.

Andrs

Villalobos

Jun-2012

1.7 Se eliminan mensajes de envo de voucher para

transacciones de detalle de ventas y total de ventas.

Se detalla proceso de envo de Detalle de Transacciones.

Se incorpora la funcionalidad de Mensajes Intermedios

para una transaccin de Venta.

Se incorpora comando para cambio de modalidad a POS

Normal

Andrs

Villalobos

Jul-2012

1.8 Cambio de estructura del documento.

Se eliminan referencias en texto y mensajera a impresin

de Voucher opcional (Solo imprime POS).

Se elimina informacin detallada de Voucher.

Se ajusta mensajera de transacciones a aplicativo POS.

Las cuotas son ingresadas en el POS.

Actualizacin Flujos de Venta y Otros.

Excel Incrustado se agrega como anexo en el documento.

Sebastin

Gonzlez

Oct-2012

Manual Integracin


Pgina 5

1.9 Se agregan los siguientes campos en la transaccin de

venta; Empleado, Propina

Se agregan los siguientes campos en la transaccin de

Ultima Venta; Numero Cuotas, Monto Cuotas, Empleado,

Propina

Se agregan los siguientes campos en la transaccin de

Detalle de Ventas; Empleado, Propina, Monto Cuotas,

Numero Cuotas.

Estos cambios permiten obtener la misma informacin de

respuesta a la caja en las tres transacciones mencionadas

Se agrega el comando que permite informar a la caja que

la transaccin fue cancelada desde el POS.

Andrs

Villalobos

Oct-2012

2.0 Se remplaza la palabra HOST por Autorizador Andres

Villalobos

Ene-2013

2.2 Se elimina la referencias a modelo POS Vx510

Se cambian imgenes de conexin de Vx510 por Vx520 sin

hacer referencia a l.

Marcelo

Oteiza

Julio-2014

Manual Integracin


Pgina 6

1. Objetivo

El siguiente documento tiene por objetivo especificar las funcionalidades que debe implementar un

proveedor de software para utilizar un POS Integrado, y realizar transacciones con tarjetas

Crdito/Debito con Transbank utilizando la comunicacin serial de un PC o Caja.

Las transacciones soportadas por los equipos POS de Transbank son:

Carga de Llaves.

Venta.

Cierre.

Anulacin.

Ultima Venta.

Detalle de Ventas.

Totales.

Pooling.

Cambio de modalidad a POS Normal.

La comunicacin con Transbank y la lgica del procesamiento de una transaccin financiera es

realizada por los equipos POS, facilitando as la integracin con un sistema de caja.

2. Requerimientos de Hardware

La Caja o PC debe tener disponible una puerta serial RS232 para la conexin con el

POS de Transbank.

Enchufe con 220 Volts para alimentacin del POS.

Manual Integracin


Pgina 7

3. Transacciones Soportadas.

3.1 Transaccin de Venta

Comando enviado por la caja solicitando la ejecucin de una venta. El comando de venta soporta

los siguientes parmetros que pueden ser enviados desde la caja:

Monto de la Transaccin: Monto en pesos informado al POS. Este monto ser enviado a

Transbank para realizar la autorizacin.

Nmero Ticket/Boleta: Este nmero lo imprime el POS en el voucher que genera por la

venta.

Enviar Mensajes: Parmetro que le indica al POS si debe enviar mensajes intermedios a

la Caja mientras se realiza el proceso de venta. Los mensajes intermedios que enva el

POS y que deben ser mostrados por la Caja, deben corresponder segn los siguientes

cdigos:

o Lectura de Tarjeta Cdigo 78

o Confirmacin de Monto Cdigo 80

o Seleccin de Cuotas Cdigo 79

o Ingreso de Pinpass Cdigo 81

o Envo de Tx a Transbank Cdigo 82

Excepciones:

La transaccin de Reversa se mantiene igual, es decir, en caso de enviar una solicitud y no tener

respuesta del Autorizador, se guarda una reversa y es enviada en la siguiente transaccin que se

realice.

Manual Integracin


Pgina 8

3.2 Transaccin ltima Venta

Comando enviado por la caja, solicitando al POS los datos de la ltima venta realizada.

Excepciones

Al momento de ejecutar un cierre se borran todas las transacciones almacenadas en la memoria

del POS.

Si el POS recibe el comando ltima Venta y no existen transacciones en memoria del POS, se

enva la respuesta a la caja indicando el error (ver Tabla de Respuestas).

3.3 Transaccin Anulacin Venta

La transaccin de anulacin siempre ser de responsabilidad de la caja y es quien decide cuando

realizar una anulacin, considerando que slo pueden ser anuladas las transacciones que se

encuentran en la memoria del POS.

El comando de anulacin soporta los siguientes parmetros que pueden ser enviados desde la

caja.

Nmero de Operacin: Valor enviado al POS, impreso en el Voucher de Venta. Le indica al POS

la transaccin en memoria que se desea anular.

Como respuesta el POS enviar cdigo de aprobacin correspondiente al campo 38 del ISO, y

adems de un cdigo de aprobacin correspondiente (ver Tabla de Respuestas), y en caso de ser

rechazada el cdigo de rechazo enviado corresponde al tipo de rechazo definido (ver Tabla de

Respuestas).

Manual Integracin


Pgina 9

3.4 Transaccin de Cierre.

Este comando es gatillado por la caja y no recibe parmetros. El POS ejecuta la transaccin de

cierre contra el Autorizador (no se contempla Batch Upload). Como respuesta a la caja se enviar

un aprobado o rechazado (ver Tabla de Respuestas).

Excepciones

Para el cierre no se solicita tarjeta supervisora.

3.5 Transaccin Detalle de Ventas

Este comando debe ser gatillado por la caja para solicitar al POS todas las transacciones que se

han realizado y permanecen en la memoria del POS.

Importante: Un Cierre de Terminal, vaca la memoria del POS.

El comando de Detalle de Ventas soporta los siguientes parmetros que pueden ser enviados

desde la caja:

Detalle a la Caja: Valor enviado al POS, indica si el POS realizara slo la impresin del

detalle de ventas o debe enviar el detalle de ventas a la Caja (transaccin por transaccin).

3.6 Transaccin Totales

Esta transaccin es gatillada por la caja para solicitar al POS el Total de las transacciones que se

han realizado y permanecen en memoria (Un cierre de terminal, vaca la memoria).

3.7 Transaccin Carga de Llaves

Manual Integracin


Pgina 10

Esta transaccin solo ser utilizada por la caja como una prueba de conexin con Transbank como

respuesta el POS enviar un aprobado o rechazado (ver Tabla de Respuestas).

3.8 Transaccin de Pooling

Esta transaccin es enviada por la caja para saber si el POS est conectado. El POS responde con

un ACK.

3.9 Cambio de Modalidad a POS Normal

Este comando le permitir a la caja, realizar el cambio de modalidad a travs de un comando.

El POS debe estar en modo integrado y al recibir el comando quedara en modo normal.

4. Diagramas de Secuencia

4.1 Venta

CAJA PINPAD HOST

Requer. (Venta)

ACK/NAK

Requer. Venta (0200)

Resp. Venta (0210)

Resp. (Venta)

ACK/NAK

Descripcin

La caja enva el requerimiento y espera como respuesta ACK/NACK, en caso de que llegue

un NACK, debe reintentar el envo del requerimiento 2 veces. Si recibe un ACK debe

esperar la respuesta de la transaccin.

Manual Integracin


Pgina 11

El POS solicita los datos al usuario, y enva requerimiento al Autorizador, en caso de ser

aprobada, se guarda en Batch y se enva respuesta a la caja. En caso de ser rechazada se

enva respuesta a la caja indicando el error (ver Tabla de Respuestas).

La caja al recibir la respuesta enva un ACK si el mensaje esta correcto, o un NACK para el

caso en que el LRC no corresponde.

El POS al recibir el ACK vuelve al inicio a esperar un nuevo comando, para el caso que

recibe un NACK vuelve a enviar la respuesta 2 veces ms.

4.2 ltima Venta

Caja Pinpad

Req. ltima venta

ACK/NAK

Resp. ltima venta

ACK/NAK

Descripcin

La caja enva el requerimiento y espera como respuesta ACK, Si recibe un ACK la caja debe

esperar la respuesta del POS, en caso de recibir un NACK debe reintentar enviando el

comando 2 veces.

Una vez recibida la respuesta, la caja calcula el LRC del mensaje y lo compara con el recibido,

si coinciden la caja enva un ACK al POS dando por finalizado el comando, en caso contrario

enva un NACK, y vuelve a esperar la respuesta del POS.

Manual Integracin


Pgina 12

4.3 Anulacin

Caja Pinpad Host

Req Anulacin

Req Anulacin

ACK

Resp Anulacin

Resp Host Anulacin

ACK

Descripcin

La caja enva el requerimiento y espera como respuesta ACK/NACK, encaso de que llegue



El POS enva requerimiento al Autorizador, en caso de ser aprobada, se guarda en Batch y

se enva respuesta a la caja. En caso de ser rechazada se enva respuesta a la caja

indicando el error.





Manual Integracin


Pgina 13

4.4 Cierre

Caja Pinpad Host

Req (Cierre)

Respuesta (ACK)

Req Cierre(0500)

Resp Cierre (0510)

Resp (Cierre)

ACK

Descripcin




El POS enva requerimiento al Autorizador, en caso de ser aprobada, se borra Batch y se

enva respuesta a la caja. En caso de ser rechazada se enva respuesta a la caja indicando

el error.





Manual Integracin


Pgina 14

4.5 Carga de Llaves

Caja Pinpad Host

Req (Carga Llaves)

Respuesta (ACK)

Req Carga Llaves(0800)

Resp Carga Llaves (0810)

Resp (Carga Llaves)

ACK

Descripcin




El POS enva requerimiento al Autorizador, en caso de ser aprobada, se guarda nueva

llave y se enva respuesta a la caja. En caso de ser rechazada se enva respuesta a la caja

indicando el error.





Manual Integracin


Pgina 15

4.6 Pooling

Caja Pinpad

Requerimiento (Pooling)

Respuesta (ACK)

Descripcin

La caja enva el requerimiento y espera como respuesta ACK, Si recibe un ACK indica que

el POS est funcionando y listo para recibir un comando, en caso de no recibir el ACK,

indica que el POS esta con problema y debe reintentar enviando el comando de pooling al

menos 3 veces.

5. Especificacin de Protocolo de Comunicacin Caja - POS

La comunicacin es a travs de una puerta serial RS232, a velocidades que van desde los 1200

Bps hasta 115200 Bps (8N1).

5.1 Esquema de Comunicacin Caja - POS

CAJAPINPAD

VX-700

REQ. DATOSLRC

ACK/NAK

RESP. DATOSLRC

ACK/NAK

Timeout1

Timeout2

POS

Manual Integracin


Pgina 16

Todos los comandos que se envan desde la Caja al POS deben cumplir con este flujo.

5.2 Flujo de la Comunicacin Caja - POS

ACK: Lo enva el POS o la caja como aviso de recepcin OK (valor Hexa 0x06).

NACK: Lo enva el POS o la caja cuando el LRC calculado no corresponde al enviado

(valor Hexa 0x15).

Timeout1: Es el tiempo de espera del ACK o NACK para reintentar el envi del

requerimiento por la caja y la respuesta desde el POS.

El formato para los requerimientos y respuestas: .

LRC: Es un byte que se concatena luego del y que se calcula realizando un XOR

byte a byte del mensajes, incluyendo DATA + ETX.

Timeout2: Es el tiempo de espera de la respuesta por la caja luego de recibir el ACK del

requerimiento.

STX: Indica el INICIO del mensaje (valor Hexa 0x02).

ETX: Indica el FIN del mensaje (valor Hexa 0x03).

6. Mensajera de Comandos

Consideraciones Generales de Mensajera

La separacin entre campos se realiza con el carcter | (valor Hexa 0x7C), evitando rellenar los

datos, es decir; para rescatar la informacin tanto la caja como el POS, debe buscar este carcter.

Ejemplo: Transaccin de Venta 0200|5000|0|0LRC, Respuesta

0210|00|0|597001600148|65000010|123456|5000|x|1234|1|C|MC|11032010|095500|xxxxxx

xxxxxLRC

Manual Integracin


Pgina 17

6.1 Venta

6.1.1 Solicitud Venta

DATO LARGO COMENTARIO

1 Indica inicio de comando Valor Hexa 0x02

Comando 4 Valor 0200

Separador de campo 1 Valor | Hexa 0x7c

Monto 9 Valor Numrico


Nmero Ticket/Boleta 20 Valor alfanumrico




Enviar Mensajes

1 Indica si el POS debe enviar mensajes de estatus

de la transaccin (1=Enva Mensajes, 0=No enva

mensajes).

1 Indica Fin de comando Valor Hexa 0x03

1 Byte resultado de la operacin XOR del mensaje

6.1.2 Mensajes Intermedios

La cantidad de mensajes intermedios depender del tipo de venta que se est realizando.





Cdigo Mensaje 2 Valor Numrico (Ver Tabla de Respuestas)



Manual Integracin


Pgina 18

6.1.3 Respuesta Venta





Cdigo Respuesta 2 Valor Numrico


Cdigo de comercio 12 Valor Numrico


Terminal ID 8 Valor Alfanumrico




Cdigo Autorizacin 6 (Mximo) Valor Alfanumrico


Monto 9 (Mximo) Valor Numrico


Numero de Cuotas 2 Valor Numrico


Monto Cuota 9

(Mximo)

Valor Numrico


ltimos 4 Dgitos Tarjeta 4 Valor Numrico


Nmero Operacin 6 (Mximo) Correlativo de Transaccin del Terminal


Tipo de Tarjeta

(Crdito/Debito)

2 CR=Crdito

DB=Debito


Fecha Contable 6 Valor Ascci. Se utiliza si es tarjeta Debito


Nmero de Cuenta 19 Valor Ascci. Se utiliza si es tarjeta Debito

Manual Integracin


Pgina 19


Abreviacin Tarjeta 2 Ver Tabla de Abreviacin de Tarjetas


Fecha Transaccin 8 Formato DDMMAAAA


Hora Transaccin 6 Formato HHMMSS


Empleado 4 Valor Numerico


Propina 9(Mximo) Valor Numerico

Separador de campo 1 (opcional) Valor | Hexa 0x7c



6.2 ltima Venta

6.2.1 Solicitud ltima Venta


1 Indica inicio de comando Valor

Hexa 0x02



1 Indica Fin de comando Valor

Hexa 0x03

1 Byte resultado de la operacin

XOR del mensaje

6.2.2 Respuesta ltima Venta



Hexa 0x02


Manual Integracin


Pgina 20
















Monto Cuota 9(Mximo) Valor Numrico




Nmero Operacin 6 (Mximo) Correlativo de Transaccin

del Terminal


Tipo de Tarjeta

(Crdito/Debito)

2 CR=Crdito

DB=Debito


Fecha Contable 6 Valor Ascci. Se utiliza si es

tarjeta Debito


Nmero de Cuenta 19 Valor Ascci. Se utiliza si es

tarjeta Debito


Abreviacin Tarjeta 2 Ver Tabla de Abreviacin de

Tarjetas


Manual Integracin


Pgina 21








Separador de campo 1(opcional) Valor | Hexa 0x7c


Hexa 0x03


XOR del mensaje

6.3 Anulacin

6.3.1 Solicitud Anulacin



Hexa 0x02




del Terminal



Hexa 0x03


XOR del mensaje

6.3.2 Respuesta Anulacin



Manual Integracin


Pgina 22

Hexa 0x02












del Terminal


Hexa 0x03


XOR del mensaje

6.4 Cierre

6.4.1 Solicitud de Cierre



Hexa 0x02





Hexa 0x03


XOR del mensaje

Manual Integracin


Pgina 23

6.4.2 Respuesta de Cierre



Hexa 0x02










Hexa 0x03


XOR del mensaje

6.5 Detalle de Ventas

Este comando le permitir a la Caja, tener la data de todas las transacciones que fueron

ejecutadas en el POS y que an se encuentran en la memoria de este.

En este caso el campo de solicitud Detalle a la Caja indica si el POS realizar slo la impresin

del detalle de ventas en el POS o enviar a la caja el detalle de ventas, transaccin por transaccin

Las dos opciones que maneja este comando para obtener el detalle de transacciones en memoria

del equipo son:

o Valor 0: El POS imprime voucher con el detalle completo de transacciones que

existen en memoria.

o Valor 1: El POS enva a la Caja el detalle de transacciones realizadas y

almacenadas en la memoria del POS. Entre cada transaccin la Caja debe enviar

Manual Integracin


Pgina 24

un ACK al POS. El POS en la ltima trx que enva responde con el mismo formato

de mensaje pero el cdigo de autorizacin en blanco.

Detalle a la Caja Valor

Imprime POS 0

Enva Data a la Caja 1

6.5.1 Solicitud Detalle de Ventas



Hexa 0x02



Detalle a la Caja 1 Valor Numrico



Hexa 0x03


XOR del mensaje

6.5.2 Respuesta Detalle de Ventas



Hexa 0x02









Manual Integracin


Pgina 25










del Terminal


Tipo de Tarjeta

(Crdito/Debito)

2 CR=Crdito

DB=Debito


Fecha Contable 6 Valor Ascci. Se utiliza si es

tarjeta Debito


Nmero de Cuenta 19 Valor Ascci. Se utiliza si es

tarjeta Debito


Abreviacin Tarjeta 2 Ver Tabla de Abreviacin de

Tarjetas










Monto Cuota 9(Mximo) Valor Numrico



Manual Integracin


Pgina 26

Separador de campo 1(opcional) Valor | Hexa 0x7c


Hexa 0x03


XOR del mensaje

6.6 Totales

Esta operacin le permitir a la caja tener un resumen de totales con las transacciones que fueron

procesadas.

Adems la Caja podr determinar si existen transacciones que no fueron informadas desde el

POS, haciendo una comparacin de los Totales que tiene la Caja y el POS.

La impresin del Voucher de totales ser realizada por el POS.

6.6.1 Solicitud Totales:



Hexa 0x02





Hexa 0x03


XOR del mensaje

6.6.2 Respuesta Detalle de Totales



Manual Integracin


Pgina 27

Hexa 0x02



Nmero de TX 3 Valor Numrico


Totales 9 Valor Numrico


Hexa 0x03


XOR del mensaje

6.7 Carga de Llaves

6.7.1 Solicitud Carga de Llaves



Hexa 0x02



Hexa 0x03


XOR del mensaje

6.7.2 Respuesta Carga de Llaves



Hexa 0x02






Manual Integracin


Pgina 28





Hexa 0x03


XOR del mensaje

6.8 Pooling

6.8.1 Solicitud Pooling



Hexa 0x02



Hexa 0x03


XOR del mensaje

6.8.2 Respuesta Pooling


1 Comando recibido OK

Valor Hexa 0x06

6.9 Cambio de Modalidad a POS Normal

Esta funcin le permitir a la caja, realizar el cambio de modalidad a travs de un comando.

El POS debe estar en modo integrado y al recibir el comando quedara en modo normal.

Manual Integracin


Pgina 29

6.9.1 Solicitud Cambio Modalidad a POS Normal:



Hexa 0x02




Hexa 0x03


XOR del mensaje

6.9.2 Respuesta Cambio Modalidad a POS Normal:


1 Comando recibido OK

Valor Hexa 0x06

7. Voucher

Los voucher sern impresos por el POS para todos los casos.

Manual Integracin


Pgina 30

8. Flujos de Venta y Otros

8.1 Flujo TX 3.20 con boleta, propina, empleado

TRANSBANK

1. VISA-AMEX-DINERS-MC

2. REDCOMPRA

3. OTRAS

Deslice o Inserte

Tarjeta

Monto $5.000

Propina $1.000

Total $6.000

Boleta :12398

Empleado :1001

Si el parmetro propina,

boleta o empleado esta

habilitado.

Monto Cuota $2.000

Venta Sin Interes

PROMOCION EMISOR

CONFIRME CUOTA

ENTREGUE

POSIngrese Clave

****Conectando...

Informe a la

Caja

Sin Cuotas

3 Cuotas Sin Interes

Cuotas Normal

Cuotas Comercio

8.2 Flujo TX 3.20 sin boleta, propina, empleado

TRANSBANK


2. REDCOMPRA

3. OTRAS

Deslice o Inserte

Tarjeta

Monto Cuota $2.000

Venta Sin Interes

PROMOCION EMISOR

CONFIRME CUOTA

ENTREGUE

POSIngrese Clave

****Conectando...

Informe a la

Caja

Sin Cuotas

3 Cuotas Sin Interes

Cuotas Normal

Cuotas Comercio

Manual Integracin


Pgina 31

8.3 Flujo TX 3.40 con boleta, propina, empleado

Transbank

1. Visa-MC-AMEX-DINERS

2. REDCOMPRA

3. OTRAS

Deslice o Inserte

Tarjeta

Monto $5.000

Propina $1.000

Total $6.000

Boleta :12398

Empleado :1001

F1: Sin Cuotas

F2: Con Cuotas

Sin Cuotas

Ingrese Cuota:

Calculo de

Cuota en el POS

Consulta de

Cuota

Monto Cuota $2.000

Venta Sin Interes

PROMOCION EMISOR

CONFIRME CUOTA

ENTREGUE

POS

Ingrese Clave

****

Conectando...

Informe a la

Caja

Con Cuotas

Sin Cuotas



habilitado.

Manual Integracin


Pgina 32

8.4 Flujo TX 3.40 sin boleta, propina, empleado

Transbank

1. Visa-MC-AMEX-DINERS

2. REDCOMPRA

3. OTRAS

Deslice o Inserte

Tarjeta

Monto $5.000

Propina $1.000

Total $6.000

Boleta :12398

Empleado :1001

F1: Sin Cuotas

F2: Con Cuotas

Sin Cuotas

Ingrese Cuota:

Calculo de

Cuota en el POS

Consulta de

Cuota

Monto Cuota $2.000

Venta Sin Interes

PROMOCION EMISOR

CONFIRME CUOTA

ENTREGUE

POS

Ingrese Clave

****

Conectando...

Informe a la

Caja

Con Cuotas

Sin Cuotas



habilitado.

Manual Integracin


Pgina 33

8.5 Cambio de modalidad POS Normal a POS Integrado

TRANSBANK


2. REDCOMPRA

3. OTRAS

TRANSBANK

1. VENTA

2. CIERRE

3. COMERCIO

4.CONFIGURACION

TRANSBANK

1. ANULACION

2. REIMPRIMIR

3. REPORTES

4.ACTUALIZACION

5. ENVO CUPON

6. POS INTEGRADO

TRANSBANK

1. ACTIVAR

2. SETEO DE COM

3. VELOCIDAD COM

Nota: Este flujo es referencial ya que el men que se muestra en el paso 3 depender de los

productos que el comercio tenga activados.

8.6 Cambio de modalidad POS Integrado a POS Normal

TRANSBANK

ESCUCHANDO...

Presiona Tecla #

TRANSBANK

1. DESACTIVAR

2. SETEO DE COM

3. VELOCIDAD COM

TRANSBANK


2. REDCOMPRA

3. OTRAS

SI

TRANSBANK

ESCUCHANDO...

NO

Manual Integracin


Pgina 34

9. Tipos de Conexin a POS

9.1 Conexin con Cable Serial

Los equipos de POS Integrado tienen una conexin serial en la parte posterior identificado como

RS232 donde se conecta el cable serial provisto por Transbank.

El otro extremo debe ir conectado al PC en su puerto serial.

ETH = Ethernet

Conexin LAN Internet

RS232: Cable Serial

POS/Caja

Conexin

Corriente

Manual Integracin


Pgina 35

Todos los cables conectados deberan estar de la siguiente forma:

9.2 Conexin POS Integrado con cable LAN para comunicacin con

Transbank

El equipo por defecto viene configurado para recibir las IP por DHCP. Tambien esta la posibilidad

de configurar la IP de manera fija (Debe consultar a Transbank).

Para que el equipo logre comunicarse con los servidores de Transbank, es necesaria la habilitacion

de los siguientes traficos en la RED del comercio:

DESARROLLO

200.10.12.16 puerto 4100

200.10.12.216 puerto 8087

Manual Integracin


Pgina 36

9.3 Conexin POS Integrado con cable TELEFNICO para comunicacin con

Transbank

El equipo por defecto viene configurado para discar los nmeros telefnicos del ambiente de

desarrollo de Transbank. El equipo permite agregar un codigo PABX si la lnea telefnica usada

est conectada a una central. (Debe consultar a Transbank).

Manual Integracin


Pgina 37

10. Tabla Abreviacin de Tarjetas

TARJETA ABREVIACION

VISA VI

MASTERCARD MC

CABAL CA

CREDENCIAL CR

AMEX AX

CERRADA CE

DINNERS DC

PRESTO TP

MAGNA MG

MAS TM

RIPLEY RP

EXTRA EX

CMR TC

REDCOMPRA DB

Pgina 38

11. Tabla de Respuestas

Aprobado 00

Rechazado 01

Host no Responde 02

Conexin Fallo 03

Transaccin ya Fue Anulada 04

No existe Transaccin para Anular 05

Tarjeta no Soportada 06

Transaccin Cancelada desde el POS 07

No puede Anular Transaccin Debito 08

Error Lectura Tarjeta 09

Monto menor al mnimo permitido 10

No existe venta 11

Transaccin No Soportada 12

Debe ejecutar cierre 13

Solicitando Conformar Monto 80

Solicitando Ingreso de Clave 81

Enviando transaccin al Host 82

Pgina 39

12. ANEXO 1

CONFIDENCIALIDAD DE LA INFORMACIN.

De acuerdo a las normativas vigentes, las transacciones con Tarjeta de Crdito y Dbito requieren

la incorporacin de los siguientes elementos de seguridad en el sistema:

La informacin de la banda magntica leda en el punto de venta NO debe ser almacenada en

ningn sistema. Para efectos de cuadratura e identificacin de transacciones, se debe utilizar el

NMERO DE TRANSACCIN.

TRATAMIENTO DE LOS TRACKS DE LA TARJETA

La informacin grabada en el Track I y Track II ser leda slo por los dispositivos de seguridad

(POS). Estos dispositivos procedern a encriptar el contenido del Track I y Track II para que esta

informacin no quede en claro.

El algoritmo de encriptacin utilizado para los tracks I y II es DES.

TRATAMIENTO DE LA DATA SENSIBLE.

Para asegurar la confidencialidad de la informacin, los mensajes de las transacciones o al menos

los datos sensibles (adems del PIN) deben viajar encriptados en los distintos tramos de la

conexin, tanto en el requerimiento como en la respuesta. Como datos sensibles se consideran:

nmero de tarjeta, fecha expiracin, nmero de cuenta y monto de la transaccin (dato validado en

Autenticacin de Mensajes o MAC).

EL MODELO MSTER/SESIN KEY

El mtodo actual de administracin de llaves es el llamado Mster/Session Key, en el cual los PED

(Pin Entry Device) son cargados en un ambiente seguro con una Master Key y en forma remota se

carga la Working Key o Session Key.

El procedimiento actual para cifrar en los Pin Pads un PinBlock es el siguiente:

Se descifra la Working Key usando la Master Key que tiene cargado el PED.

Con la Working Key, se cifra el PinBlock y se enva al servidor.

La Working Key se cambia en forma peridica (al menos en cada cierre), para evitar que sea

descubierta por terceros.

Este modelo de administracin de llaves es el que se usar para las llaves MAC.

Nota: esta funcionalidad no se ve impactada por la incorporacin de transacciones con Chip

Pgina 40

EL MODELO DUKPT ENCRIPTACION DE PIN

El nuevo mtodo de administracin de llaves para PIN que usar Transbank es el denominado

Llave nica derivada por transaccin o DUKPT por sus iniciales en ingls.

Bajo este mtodo los PED son inicializados en un ambiente seguro, con datos de identificacin

propios de cada PED (Identificador de la llave de derivacin, Identificador de PED nico y un

contador de transacciones iniciado en cero), ms una llave inicial que se calcula usando los datos

propios de cada PED y la llave de derivacin base. Con esta llave inicial se genera la prxima llave

de cifrado para PIN. Este proceso se realiza con una funcin asimtrica (DUKPT del PinPad), es

decir, una funcin de un solo sentido, de forma que el PED no sea capaz de generar ninguna llave

anterior a la actual.

CALCULO DE MAC

Para asegurar la integridad de la informacin que viaja desde y hacia el Autorizador de comercio,

se introduce un cdigo de autenticacin de mensajes (MAC) el cual es enviado en el mensaje de

requerimiento y validado por el Autorizador de Transbank al recibirlo. A su vez, el Autorizador de

Transbank enva un cdigo de MAC para el mensaje de respuesta, el cual debe ser validado por la

caja. Si la validacin que hace la caja del cdigo de MAC es negativa debe generar una reversa.

La transaccin de reversa debe ser igual a la respuesta recibida pero con el campo RESPONSE

CODE con el valor 989 y el campo MESSAGE SUBTYPE en R. Cuando el Autorizador de

Transbank detecta un MAC invlido en el mensaje de requerimiento, enva un mensaje de

respuesta con cdigo de rechazo 898 (MAC invlido).

MANEJO DE LLAVES MAC (MESSAGE AUTHENTICATION CODE)

Las llaves criptogrficas para la generacin de MAC (working key de MAC) se maneja de acuerdo

a lo siguiente:

Las working key son generadas por el sistema de Transbank y transmitidas en lnea para cada uno

de los terminal ID definidos en el comercio cliente.

Para la carga y / o cambio de la working keys de MAC se utilizan las transacciones de CIERRE

BATCH y CARGA DE LLAVE (Ver Transacciones Administrativas).

Las llaves working keys de MAC se actualizan en cada nueva transaccin atendida por Transbank.

Por lo que la caja debe registrar esta nueva llave para su uso en la siguiente transaccin.

Pgina 41

Las llaves se deben cambiar automticamente todos los das. Esto implica que debe existir un

procedimiento de inicializacin o cierre obligatorio en cada caja (terminal ID) que se ejecuta en

forma automtica todos los das y que como parte de este procedimiento se enva a Transbank una

transaccin de CIERRE BATCH o CARGA DE LLAVE por cada caja (terminal ID).

Las working keys (MAC) se transmiten encriptadas utilizando el algoritmo DES (dato a encriptar es

la working key) con una llave de encriptacin denominada master key, definida por Transbank.

Transbank define una master key para PIN y otra master key para MAC.

Transbank carga inicialmente las master keys en cada PIN-PAD, operacin que se realiza

previamente a la instalacin de stos en las cajas.

Para la carga de las master keys de PIN y MAC, el modelo de PIN-PAD utilizado debe contar con

un dispositivo cargador de llaves que ser administrado por Transbank y que permite:

Ingresar las master keys en el dispositivo, la que no podr ser modificada, violada o adulterada.

Cargar las master keys conectando uno por uno los PIN-PAD al dispositivo

MANEJO DE CLAVE TCNICO

Para acceder a los menues de perfil tcnico, deber acreditarse con el RUT y la Clave que

corresponde a este rut.

Esta clave es de generacin dinmica, con caducidad mxima en 31 dias.

El algoritmo y el detalle de esta funcionalidad ser entregado a demanda, por el carcter de

confidencialidad del algoritmo.

MANEJO DE CLAVE SUPERVISORA

Hasta la versin 3.40, cada comercio tena una tarjeta supervisora que le permita autenticarse

para realizar cierres, anulaciones y otras operaciones. A partir de la versin 4.0, durante el proceso

de autoinstalacin se solicitar la digitacin de la clave supervisora, quedando esta almacenada

hasta que el comercio desee cambiarla, siendo esta responsabilidad del mismo.

Si el comercio olvida esta clave, existe una clave maestra de comercio que permite la digitacin de

una nueva clave de comercio.

MANEJO DE CLAVE MAESTRA DE COMERCIO / ACTIVACION

Hasta la versin 3.40, cada comercio tena una tarjeta supervisora que le permita autenticarse

Pgina 42

13. Anexo 2: Detalle campos de cada transaccin

LISTADO DE

TRANSACCIONES

CAMPOS

Solic

itud/R

espuesta

Fu

ncio

n

Codig

o R

espuesta

Codig

o C

om

erc

io

Te

rmin

al Id

Nm

ero

de T

icket/B

ole

ta

Codig

o A

uto

rizacio

n

Mo

nto

ltim

os 4

Dig

itos T

arj

eta

Num

ero

Opera

ci

n

Tip

o d

e T

arjeta

Fe

cha C

onta

ble

Nm

ero

de C

uenta

Abre

via

ci

n M

arc

a T

arje

ta

Fe

cha R

eal T

ransaccio

n

Hora

Real T

ransaccio

n

Para

me

tro Im

pre

si

n

Envia

r M

ensaje

s

Deta

lle a

la

Caja

Num

ero

de T

x

To

tale

s

Largo del Campo 4 2 12 8 20 6 9 4 6 2 6 19 2 8 6 1 1 1 3 9

1

Transaccin Venta Crdito/Debito (Desde Caja -> POS) Solicitud 0200 x x x

(Desde POS -> Caja) Respuesta 0210 x x x x x x x x x x x x x x

2

Mensajes de estatus de la transaccin (Desde Pinpad -> POS) Respuesta 0900 x

3 Solicitud ltima Venta (Desde Caja -> POS) Solicitud 0250


4

Transaccin Anulacin de Venta (Desde Caja -> POS) Solicitud 1200 x

(Desde POS -> Caja) Respuesta 1210 x x x x x

5 Transaccion de Cierre (Desde Caja -> POS) Solicitud 0500

(Desde POS -> Caja) Respuesta 0510 x x x

Pgina 43

6

Transaccin Detalle de Ventas (Desde Caja -> POS) Solicitud 0260 x


7 Transaccin Totales (Desde Caja -> POS) Solicitud 0700

(Desde POS -> Caja) Respuesta 0710 x x

8

Transaccion Carga Llaves (Desde Caja -> POS) Solicitud 0800

(Desde POS -> Caja) Respuesta 0810 x x x

9

Pooling -Probar comunicaciones con Pinpad (Desde Caja -> POS) Solicitud 0100

(Reponde ACK) Respuesta

10

Cambio de Modalidad a POS Normal (Desde Caja -> POS) Solicitud 0300

(Reponde ACK) Respuesta

manual de integración pos intergrado (Último)

Documents