Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Plataforma Fullcarga
Especificacin tcnica para los clientes H2H con el protocolo ISO8583
David Soria Ortiz Departamento de tecnologa. 16 de abril de 2009 Especificacin tcnica para los clientes H2H con el protocolo ISO8583 v1.2 Ver.
1.0 1.1 1.2 1.3 1.4
Fecha
16/04/2009 10/12/2009 16/12/2009 30/05/2011 01/08/2011
Autor
David Soria Ortiz Beatriz Brun David Soria Ortiz David Soria Ortiz David Soria Ortiz
Notas
Documento: FCI Especificacin tecnica para los H2H con el protocolo ISO8583_v1.4.docx Fecha: 29/08/2011
2/25 v1.2/r1
ndice
1. 2. Introduccin ........................................................ 4 Protocolo de comunicacin ...................................... 5 2.2. Seguridad en los datos. ........................................... 6 2.3. Versin de protocolo .............................................. 7 3. Operaciones. ....................................................... 8 3.1. Operacin Echo. .................................................. 11 3.2. Operacin de venta .............................................. 12 3.3. Operacin de Devolucin ........................................ 17 3.4. Operacin de Consulta ........................................... 19 3.5. Operacin de consulta de saldo. ............................... 21 3.6. Respuesta Errnea ................................................ 23 4. Consulta en caso de operacin demorada o fallo de comunicacin 25
Documento: FCI Especificacin tecnica para los H2H con el protocolo ISO8583_v1.4.docx Fecha: 29/08/2011
3/25 v1.2/r1
1. Introduccin
En este documento se describir el comportamiento en cuanto a funcionalidades y protocolo de comunicacin que deben implementar los clientes H2H que se comuniquen con la plataforma transaccional de Fullcarga.
Documento: FCI Especificacin tecnica para los H2H con el protocolo ISO8583_v1.4.docx Fecha: 29/08/2011
4/25 v1.2/r1
2. Protocolo de comunicacin
El protocolo utilizado para la comunicacin entre el cliente H2H y el Host de la plataforma transaccional se basa en el protocolo ISO-8583. Adems del contenido de los campos ISO las tramas incluirn una cabecera que consta de: 2 Bytes en binario para la longitud de la trama (sin incluir los 2 bytes de este campo) 5 Bytes para el TPDU (El valor para los H2H ser, 0x00, 0x00, 0x00, 0x00, 0x00 representado en hexadecimal).
Por lo tanto las tablas quedarn como: LEN (2 bytes) TPDU (5 bytes) DATA
2.1.1.
El protocolo bsico de las operaciones constar de una peticin realizada por el cliente H2H, y una respuesta enviada por el HOST antes de un time-out de 60 segundos.
TPV
Host
Tamao de la tramas.
Se ha definido un mximo de 1KB para el tamao de las tramas. Por lo que en caso de que una respuesta necesite ms cantidad de informacin, ser necesario dividir la respuesta en varias tramas.
Documento: FCI Especificacin tecnica para los H2H con el protocolo ISO8583_v1.4.docx Fecha: 29/08/2011
5/25 v1.2/r1
En todas las operaciones en las que la informacin a enviar por parte del host de Fullcarga en la respuesta sea superior a un 1KB ser necesario enviar varias tramas. Para ello el host de Fullcarga indicar en las tramas de respuesta que es necesario que el cliente H2H espere ms tramas. A cada trama de respuesta del host de Fullcarga le seguir una nueva trama de peticin del cliente H2H siempre dentro de la misma conexin. En este caso el time-out de espera del cliente H2H se volver a contar desde 0 despus de cada peticin enviada por el cliente H2H. En la ltima trama a enviar el Host de Fullcarga indicar al cliente H2H que ya no es necesario que espere ms tramas, cerrando as la conexin.
TPV
Host
Peticin Mx. 60 seg. Respuesta Peticin Mx. 60 seg. Respuesta Peticin Mx. 60 seg. Respuesta
En las tramas de respuesta en las que el host de Fullcarga indica que son necesarias ms tramas el campo PROCESS CODE (campo ISO n 3) es xxxxx1 mientras que en las que el Host de Fullcarga indica que ya no es necesario esperar ms tramas el campo PROCESS CODE es xxxxx0.
Documento: FCI Especificacin tecnica para los H2H con el protocolo ISO8583_v1.4.docx Fecha: 29/08/2011
6/25 v1.2/r1
La encriptacin utilizada ser 3DES ECB. Debido al algoritmo 3DES es necesario que cada campo encriptado se ajuste previamente a una longitud mltiplo de 8 bytes, para rellenar los campos hasta dicha longitud se utilizaran tantos byte 0x00 como sean necesarios. La clave se informar a cada cliente H2H mediante mail. Adems las tramas incluyen un campo password que se enviar encriptado, que se asignar a cada H2H, para asegurar la identificacin del cliente H2H. Por otra parte tambin se validar la IP desde la que se conecta el H2H.
Documento: FCI Especificacin tecnica para los H2H con el protocolo ISO8583_v1.4.docx Fecha: 29/08/2011
7/25 v1.2/r1
3. Operaciones.
A continuacin se describen las diferentes operaciones que debe implementar el cliente H2H, as como las tramas de peticin y respuesta correspondientes.
Importes
Tanto en las tramas de peticin como en las tramas de respuesta de las operaciones se pueden incluir diversos importes. En cualquier caso un campo que contenga informacin de importe se incluir sin separadores de miles ni de decimales. De esta forma se asumir que los ltimos X dgitos del importe corresponden a los decimales. El nmero de decimales a utilizar se informar por parte de Fullcarga al cliente H2H.
62
Documento: FCI Especificacin tecnica para los H2H con el protocolo ISO8583_v1.4.docx Fecha: 29/08/2011
8/25 v1.2/r1
ASCII HEXA
2 8
TYPE
Es en identificador ISO de tipo de operacin.
PROCCES CODE
Es el identificador que corresponde al tipo de operacin que se esta ejecutando.
STAN
Es el identificador correlativo de operacin que tiene enviar el TPV en las peticiones. No es el identificador que se utilizar como referencia del cliente H2H para la conciliacin.
TIME y DATE
Son los campos de hora y fecha. En la peticin indicarn la hora del TPV y en la respuesta la hora del Host.
TERMINAL ID
Es el cdigo de TPV asignado por la plataforma de Fullcarga.
VERSIN DE PROTOCOLO
Indica la versin del protocolo de la plataforma de Fullcarga utilizada.
PASSWORD
Es un password que se asignar a cada H2H.
61
Documento: FCI Especificacin tecnica para los H2H con el protocolo ISO8583_v1.4.docx Fecha: 29/08/2011
9/25 v1.2/r1
RESPONSE CODE
Este campo indicar el cdigo de respuesta. Si es 00 la respuesta ser correcta, si es 01 indicar que la operacin se ha demorado, por lo que ser necesario consultar el resultado mediante la operacin de consulta ver el capitulo 4 Consulta en caso de operacin demorada . En cualquier otro caso se tomar la operacin como errnea. Tener en consideracin estas transacciones como correctas hasta que las defina la operadora a travs de la consulta.
MENSAJE VENDEDOR
En este campo se podr incluir un mensaje para el H2H, o bien dejarlo vaco.
Documento: FCI Especificacin tecnica para los H2H con el protocolo ISO8583_v1.4.docx Fecha: 29/08/2011
10/25 v1.2/r1
3.1.1.
N ISO
Trama de peticin.
Campo Tipo Tamao (BYTES)
MESSAGE LENGHT TPDU TYPE (0800) BITMAP 03 11 12 13 PROCCES CODE (990000) STAN TIME (HHMMSS) DATE (MMDD)
2 5 2 8 3 3 3 2
3.1.2.
N ISO
Trama de respuesta.
Campo Tipo Tamao (BYTES)
MESSAGE LENGHT TPDU TYPE (0810) BITMAP 03 11 12 13 39 PROCCES CODE (990000) STAN TIME (HHMMSS) DATE (MMDD) RESPONSE CODE (00)
2 5 2 8 3 3 3 2 2
Documento: FCI Especificacin tecnica para los H2H con el protocolo ISO8583_v1.4.docx Fecha: 29/08/2011
11/25 v1.2/r1
3.2.1.
N ISO
Trama de peticin.
Campo Tipo Tamao (BYTES)
MESSAGE LENGHT TPDU TYPE (0200) BITMAP 03 11 12 13 41 PROCCES CODE (000100) STAN TIME (HHMMSS) DATE (MMDD) TERMINAL ID
2 5 2 8 3 3 3 2 8
60
PRIVATE (Datos operacin) (Encriptado) - Longitud del campo - Cdigo de producto - Usuario - REF H2H BCD ASCII ASCII LLV
<= 900 2 8 10
62
PRIVATE (Campos de control) Longitud del campo Versin del protocolo Password (Encriptado) BCD ASCII HEXA 2 2 8
REF H2H
Es la referencia que asigna el cliente H2H a la venta, y que se utilizar para la conciliacin.
Documento: FCI Especificacin tecnica para los H2H con el protocolo ISO8583_v1.4.docx Fecha: 29/08/2011
12/25 v1.2/r1
Usuario
El usuario se enviar fijo de longitud 10 con espacios a la derecha si fuese necesario.
Lista de parmetros
Para cada producto se definirn una lista de parmetros que se incluirn en la peticin, ya que esta informacin depende del tipo de producto, y de la informacin requerida por la operadora. Esta informacin se enva adjunto en el anexo.
Documento: FCI Especificacin tecnica para los H2H con el protocolo ISO8583_v1.4.docx Fecha: 29/08/2011
13/25 v1.2/r1
3.2.2.
N ISO
Trama de respuesta.
Campo Tipo Tamao (BYTES)
MESSAGE LENGHT TPDU TYPE (0210) BITMAP 03 04 06 11 12 13 37 39 41 51 PROCCES CODE (000100 000101) AMOUNT TRANS AMOUNT DESTINO STAN TIME (HHMMSS) DATE (MMDD) REFERENCIA LOCAL RESPONSE CODE (00) TERMINAL ID MONEDA DESTINO
HEXA HEXA BCD HEXA BCD BCD BCD BCD BCD BCD ASCII ASCII ASCII ASCII
2 5 2 8 3 6 6 3 3 2 12 2 8 3
48
60
<=900 2
61
Documento: FCI Especificacin tecnica para los H2H con el protocolo ISO8583_v1.4.docx Fecha: 29/08/2011
14/25 v1.2/r1
Lista de parmetros
Para cada producto se definirn una lista de parmetros que se incluirn en la respuesta, ya que esta informacin depende del tipo de producto, y de la informacin requerida por la operadora.
Documento: FCI Especificacin tecnica para los H2H con el protocolo ISO8583_v1.4.docx Fecha: 29/08/2011
15/25 v1.2/r1
AMOUNT TRANS
Es el importe de la venta. Como todos los importes ira sin separador de miles ni decimales, por lo que como decimales se tomaran tantos dgitos como se hayan definido.
Documento: FCI Especificacin tecnica para los H2H con el protocolo ISO8583_v1.4.docx Fecha: 29/08/2011
16/25 v1.2/r1
3.3.1.
N ISO
Trama de peticin.
Campo Tipo Tamao (BYTES)
MESSAGE LENGHT TPDU TYPE (0200) BITMAP 03 11 12 13 41 PROCCES CODE (220100 220101) STAN TIME (HHMMSS) DATE (MMDD) TERMINAL ID
2 5 2 8 3 3 3 2 8
60
PRIVATE (Datos operacin) (Encriptado) - Longitud del campo - Cdigo de producto - Usuario - REF H2H BCD ASCII ASCII LLV
<= 900 2 8 10
62
PRIVATE (Campos de control) Longitud del campo Versin del protocolo Password (Encriptado) BCD ASCII HEXA 2 2 8
REF H2H
Es la referencia que asigna el cliente H2H a la devolucin, y que se utilizar para la conciliacin.
Documento: FCI Especificacin tecnica para los H2H con el protocolo ISO8583_v1.4.docx Fecha: 29/08/2011
17/25 v1.2/r1
3.3.2.
N ISO
Trama de respuesta.
Campo Tipo Tamao (BYTES)
MESSAGE LENGHT TPDU TYPE (0210) BITMAP 03 04 06 11 12 13 37 39 41 51 PROCCES CODE (220100 220101) AMOUNT TRANS AMOUNT DESTINO STAN TIME (HHMMSS) DATE (MMDD) REFERENCIA LOCAL RESPONSE CODE (00) TERMINAL ID MONEDA DESTINO
HEXA HEXA BCD HEXA BCD BCD BCD BCD BCD BCD ASCII ASCII ASCII ASCII
2 5 2 8 3 6 6 3 3 2 12 2 8 3
48
60
<=900 2
61
Documento: FCI Especificacin tecnica para los H2H con el protocolo ISO8583_v1.4.docx Fecha: 29/08/2011
18/25 v1.2/r1
3.4.1.
N ISO
Trama de peticin.
Campo Tipo Tamao (BYTES)
MESSAGE LENGHT TPDU TYPE (0800) BITMAP 03 11 12 13 41 PROCCES CODE (400200) STAN TIME (HHMMSS) DATE (MMDD) TERMINAL ID
2 5 2 8 3 3 3 2 8
60
PRIVATE (Datos operacin) (Encriptado) - Longitud del campo - Cdigo de producto - Usuario BCD ASCII ASCII
<= 900 2 8 10
62
PRIVATE (Campos de control) Longitud del campo Versin del protocolo Password (Encriptado) BCD ASCII HEXA 2 2 8
Documento: FCI Especificacin tecnica para los H2H con el protocolo ISO8583_v1.4.docx Fecha: 29/08/2011
19/25 v1.2/r1
3.4.2.
N ISO
Trama de respuesta.
Campo Tipo Tamao (BYTES)
MESSAGE LENGHT TPDU TYPE (0810) BITMAP 03 11 12 13 37 39 41 PROCCES CODE (400200 400201) STAN TIME (HHMMSS) DATE (MMDD) REFERENCIA LOCAL RESPONSE CODE (00) TERMINAL ID
HEXA HEXA BCD HEXA BCD BCD BCD BCD ASCII ASCII ASCII
2 5 2 8 3 3 3 2 12 2 8
48
60
<=900 2
61
Documento: FCI Especificacin tecnica para los H2H con el protocolo ISO8583_v1.4.docx Fecha: 29/08/2011
20/25 v1.2/r1
3.5.1.
N ISO
Trama de peticin.
Campo Tipo Tamao (BYTES)
MESSAGE LENGHT TPDU TYPE (0800) BITMAP 03 11 12 13 41 PROCCES CODE (400300) STAN TIME (HHMMSS) DATE (MMDD) TERMINAL ID
2 5 2 8 3 3 3 2 8
62
PRIVATE (Campos de control) Longitud del campo Versin del protocolo Password (Encriptado) BCD ASCII HEXA 2 2 8
Documento: FCI Especificacin tecnica para los H2H con el protocolo ISO8583_v1.4.docx Fecha: 29/08/2011
21/25 v1.2/r1
3.5.2.
N ISO
Trama de respuesta.
Campo Tipo Tamao (BYTES)
MESSAGE LENGHT TPDU TYPE (0810) BITMAP 03 04 11 12 13 39 41 PROCCES CODE (400300) AMOUNT TRAS (SALDO) STAN TIME (HHMMSS) DATE (MMDD) RESPONSE CODE (00) TERMINAL ID
HEXA HEXA BCD HEXA BCD BCD BCD BCD BCD ASCII ASCII
2 5 2 8 3 6 3 3 2 2 8
61
Documento: FCI Especificacin tecnica para los H2H con el protocolo ISO8583_v1.4.docx Fecha: 29/08/2011
22/25 v1.2/r1
48
60
<=900 2
En caso error, el campo RESPONDE CODE indicar slo que la operacin es errnea, la descripcin del error se incluir en el primer parmetro de la Lista de parmetros del campo 60. En esta respuesta no se enviar el campo 60 encriptado. La plataforma de Fullcarga enviar dos tipos de mensajes de error dependiendo de si el error se ha detectado en las validaciones de los datos o en la propia operacin de la plataforma de Fullcarga, o bien si el error es enviado por la propia operadora. En caso de que el error sea enviado por la propia operadora el mensaje empezar siempre por NAKGW.
Documento: FCI Especificacin tecnica para los H2H con el protocolo ISO8583_v1.4.docx Fecha: 29/08/2011
23/25 v1.2/r1
Errores HS0500 El sistema esta ocupado intentelo mas tarde HS0502 El sistema esta ocupado intentelo mas tarde HS0505 La operacion no se ha podido realizar HS0506 Ha habido problemas con la operacion, consulte el estado de la misma HS1000 El POS no esta activo o no existe HS1001 La operacion no es valida HS1002 El cliente no esta activo o no existe HS1003 Operacion no esperada HS1004 La version utilizada no es valida HS1005 La diferencia horaria no permite la operacion HS1006 El tipo de comunicacion no es valido HS1008 El importe no es un valor permitido HS1009 El importe esta fuera del rango minimo-maximo HS1010 Error en la trama de confirmacion HS1012 Error en la sincronizacion HS1014 La referencia no existe HS1021 El telefono es incorrecto HS1026 El estado del producto no permite operar HS1027 El producto no esta habilitado HS1031 La trama es incorrecta HS1032 El POS no tiene mensajes pendientes HS1033 El tipo de aviso no es valido HS1050 Los datos del cliente no son correctos HS2002 No existen pines disponibles en este momento HS3005 No dispone de saldo suficiente para operar HS4003 La referencia de la venta no es valida HS4005 Error en la validacion HS4006 La venta todavia esta en proceso, consulte call center HS4007 La venta esta anulada
Documento: FCI Especificacin tecnica para los H2H con el protocolo ISO8583_v1.4.docx Fecha: 29/08/2011
24/25 v1.2/r1
Este producto tiene como nico parmetro para la operacin de consulta la referencia que el cliente ha enviado en la venta en el campo REF IVR.
Los parmetros de respuesta incluidos en el campo 60 sern los siguientes: 1.- CODIGO DE PRODUCTO Igual que en la peticin
2.- RESULTADO OK: Indicar que la operacin es correcta. En este caso el campo 37 tendr la referencia para la operacin de la plataforma Fullcarga. KO: Indicar que la operacin no ha sido correcta: bien porque no se ha recibido la peticin; bien porque ha habido algn fallo en las validaciones; bien porque la operadora ha indicado un error para la operacin o bien porque en el caso de una venta se haya podido anular. PE: Indicar que la operacin todava sigue pendiente, por lo que se tendr que seguir consultando. Si la operacin ha pasado las validaciones previas en la plataforma de Fullcarga y se ha podido registrar, el campo 37 tambin incluir la referencia de la operacin.
3.- INSTRUCCIONES Incluir un mensaje que indicar el motivo por el que la operacin consultada no fue correcta.
4.- MSJ CLIENTE Incluir cualquier otro tipo de mensaje para el cliente.
Documento: FCI Especificacin tecnica para los H2H con el protocolo ISO8583_v1.4.docx Fecha: 29/08/2011
25/25 v1.2/r1