UNIBANCA PrepagoEspecificaciónMensajesAdministrativos PDF
UNIBANCA PrepagoEspecificaciónMensajesAdministrativos PDF
UNIBANCA PrepagoEspecificaciónMensajesAdministrativos PDF
RESUMEN DE MODIFICACIONES
Ítems Responsable de
Versión Fecha Descripción de Modificaciones
Modificados la Modificación
00.00 08/02/2013 1. No hay cambios, por ser primera versión
1. Se agrega especificación de formato del PAN 4.5.1
00.01 22/03/2013 para el caso de afiliación donde la generación de Iván Tirado
5.2
número de tarjeta se realiza en UNIBANCA.
00.02 03/04/2013 1. Se agrega especificación de formato del campo 5.2.1.1 Iván Tirado
Nombre Corto en Tarjeta.
5.2.1
00.03 28/11/2013 1. Se agrega campo Código de Seguimiento en la Iván Tirado
respuesta a la transacción administrativa 0200. 5.2.1.1
1. Se adicionan campos a los archivos de las
01.00 28/01/2014 transacciones administrativas, como parte de la 5.2.1.2 Iván Tirado
migración a SPET.
01.01 01/04/2014 1. Revisión general del documento Iván Tirado
1. Se adiciona información sobre tarjetas
01.02 30/05/2014 mancomunadas y facultadas. 5.2.1 Iván Tirado
2. Se adiciona información sobre reposición de
tarjetas.
01.03 06/06/2014 1. Se agrega la especificación de los archivos de 5.6 Iván Tirado
tarjetas bloqueadas.
01.04 21/10/2014 1. Se adiciona especificación del archivo de saldos. 5.7 Iván Tirado
5.1
01.05 29/12/2014 1. Se modifica especificación de archivos de 5.3 Iván Tirado
afiliación, recarga y débito.
5.4
CONTENIDO
1. INTRODUCCIÓN __________________________________________________________ 5
2. CARACTERÍSTICAS GENERALES ___________________________________________ 6
2.1. GENERACIÓN DE TARJETA ___________________________________________ 7
2.1.1. Tarjetas nominadas ______________________________________________ 7
2.1.2. Tarjetas innominadas _____________________________________________ 8
2.2. ACTIVACIÓN DE TARJETA ____________________________________________ 8
2.2.1. Tarjetas nominadas ______________________________________________ 8
2.2.2. Tarjetas innominadas _____________________________________________ 8
2.3. RECARGA __________________________________________________________ 9
2.4. REASIGNACIÓN DE CUENTAS _________________________________________ 9
2.4.1. Tarjetas nominadas ______________________________________________ 9
2.4.2. Tarjetas innominadas _____________________________________________ 9
2.5. OTROS_____________________________________________________________ 9
3. ESQUEMA DE OPERACIÓN _______________________________________________ 10
4. MENSAJÍSTICA _________________________________________________________ 11
4.1. Identificador de tipo de mensaje ______________________________________ 11
4.2. BITMAP ___________________________________________________________ 11
4.3. Elementos de datos _________________________________________________ 12
4.4. Modo de conexión __________________________________________________ 12
4.5. Detalle de los mensajes en línea ______________________________________ 14
4.5.1. TIPO DE MENSAJE 0302 (DEL EMISOR A UNIBANCA) ________________ 14
4.5.2. TIPO DE MENSAJE 0312 (DE UNIBANCA AL EMISOR) ________________ 17
5. ARCHIVOS _____________________________________________________________ 19
5.1. Estructura del archivo de Afiliación Simple _____________________________ 19
5.2. Estructura de los mensajes (Registros) ________________________________ 21
5.2.1. Mensajes de Gestión de Tarjetas __________________________________ 22
5.2.2. TRAMA (la parte superior es común a los 3 tipos) _____________________ 24
5.2.3. Campos Adicionales_____________________________________________ 26
5.2.4. Mensajes de Gestión de Cuentas __________________________________ 28
5.2.5. Mensajes de Gestión de Relación Tarjeta-Cuenta _____________________ 29
5.3. Formato de Archivo de Recarga _______________________________________ 30
5.4. Formato de Archivo de Débito ________________________________________ 32
5.5. Formato de Archivo Informativo de Comisiones al Tarjetahabiente _________ 34
5.6. Formato de Archivo Informativo de Tarjetas Bloqueadas __________________ 35
5.6.1. Detalle Campo 48 _______________________________________________ 37
5.7. Formato de Archivo Informativo de Saldo de Tarjetas ____________________ 38
5.8. Nomenclatura de Archivos de Intercambio ______________________________ 40
1. INTRODUCCIÓN
Los consumos de estas tarjetas están limitadas por los máximos establecidos
en el control de límites on-line de UNIBANCA.
2. CARACTERÍSTICAS GENERALES
2.3. RECARGA
2.5. OTROS
3. ESQUEMA DE OPERACIÓN
SISTEMA PRE-PAGO
RED
UNICARD
Servicio INSTITUCIÓN
Web EMISORA
3
58
-8
ISO
PRE-PAGO
SWITCH
On-Line
(WS)
MC Proc Central
ATM Parking
VISA
10
4. MENSAJÍSTICA
Cada mensaje es una cadena de caracteres ASCII y está constituido por los
siguientes componentes:
0302: Administrativa.
0312: Respuesta a la administrativa.
4.2. BITMAP
Sí el primer bit del primer bitmap es uno (1), indica la presencia de un bitmap
adicional a continuación del primer bitmap (BitMap Secundario).
11
Ejemplo:
100111100101....
9 E 5 -- hexadecimal
El tercer componente son los elementos de datos en sí, cada uno de los cuales
puede estar presente o no en un determinado mensaje, indicando cada bit del
bitmap justamente su presencia (1) o ausencia (0).
Los tipos de datos que cada uno acepta, así como su longitud están
predeterminados:
12
El mensaje ISO viaja precedido por un campo de 2 bytes, con su longitud total
en 'binario' (excluyendo el campo mismo), con el objetivo de marcar sus límites
dentro del flujo continuo del protocolo TCP.
Tarjeta Prepago
-
Especificación Mensajes
Financieros
13
14
15
16
Salvo que se indique lo contrario, los valores son los mismos del mensaje 0200.
CÓDIGO DESCRIPCIÓN
00 Normal, sin errores.
25 Registro no encontrado
26 Registro duplicado en la Base de Datos
91 Data invalida
92 Fuera de rango
94 Data incompleta
95 Formato de fecha invalida
96 Formato de hora invalida
97 Monto invalido
99 Formato de mensaje invalido
17
18
5. ARCHIVOS
Los campos que no sean significativos para una transacción específica pueden
enviarse así:
19
20
La parte final de los mensajes es diferente para cada uno de los 3 formatos, y
se deriva de la estructura del bit 48 en los mensajes estándar originales.
21
22
23
24
El campo 25, en el caso que sea una tarjeta innominada, debe tener el nombre
"INNOMINADA" alineado a la izquierda.
Se resaltan (lila) los campos que pueden utilizarse (también) en la impresión de la carta de
bienvenida.
Los campos 35 y 36 del archivo a UNIBANCA (en lila) puede contener el RUC de la
empresa y el indicador de distribución.
Indicador de distribución:
Para bloquear una tarjeta de manera temporal, la institución deberá utilizar la transacción
administrativa 0222 (CARD status) con el tracking (estado de tarjeta) "X".
25
Para las reposiciones se debe enviar mensajes 0200 (Customer Card Order), para generar
la nueva tarjeta.
La Empresa Emisora deberá solicitar el reemplazo de una tarjeta utilizando la operación de
TXN-ADMIN/REASIGNACION-TARJETA, publicada en el Web Service Pre-Pago.
La tarjeta original debe estar inactiva.
27
UNIBANCA devuelve:
3 Tipo de Cuenta 0 N1
604 Sol /
4 Código de Moneda Base N3
840 Dólar
5 Fecha de último retiro YYMMDD N6
6 Hora de Ultimo retiro HHMMSS N6
7 Fecha de Ultima Actividad Financiera YYMMDD N6
8 Hora de Ultima Actividad Financiera HHMMSS N6
28
UNIBANCA devuelve:
29
REGISTRO : HEADER
TAMAÑO : 41 caracteres
REGISTRO : DETALLE
TAMAÑO : 56 caracteres
REGISTRO : TRAILER
TAMAÑO : 41 caracteres
30
Archivo de Respuesta
REGISTRO : HEADER
TAMAÑO : 41 caracteres
REGISTRO : DETALLE
TAMAÑO : 41 caracteres
REGISTRO : TRAILER
TAMAÑO : 41 caracteres
CÓDIGOS DE RESPUESTA
000 Aprobada
013 Monto inválido (o moneda)
025 Cuenta no existe
029 Rechazada (otros motivos)
31
REGISTRO : HEADER
TAMAÑO : 41 caracteres
REGISTRO : DETALLE
TAMAÑO : 56 caracteres
REGISTRO : TRAILER
TAMAÑO : 41 caracteres
32
Archivo de Respuesta
ARCHIVO : RESPUESTA A DÉBITO DE CUENTAS PREPAGO
REGISTRO : HEADER
TAMAÑO : 41 caracteres
REGISTRO : DETALLE
TAMAÑO : 41 caracteres
REGISTRO : TRAILER
TAMAÑO : 41 caracteres
CÓDIGOS DE RESPUESTA
000 Aprobada
013 Monto inválido (o moneda)
025 Cuenta no existe
029 Rechazada (otros motivos)
33
REGISTRO : HEADER
TAMAÑO : 80 caracteres
REGISTRO : DETALLE
TAMAÑO : 80 caracteres
REGISTRO : TRAILER
TAMAÑO : 80 caracteres
34
REGISTRO HEADER
TAMAÑO 1,125
REGISTRO DATOS
TAMAÑO 1,125
35
Ej. 06654321
Donde:
06=longitud
654321=BIN)
8 0064-0065 2 N Código de respuesta. Debe ir "00".
Donde:
9 0066-0158 N..90 AN LLLVAR LLL=longitud
Ver detalle del BIT 48.
10 0159-1125 967 AN AN Deben ser espacios en blanco.
REGISTRO TRAILER
TAMAÑO 1,125
36
37
REGISTRO HEADER
TAMAÑO 15
REGISTRO DATOS
TAMAÑO 60
38
REGISTRO TRAILER
TAMAÑO 15
39
2) De UNIBANCA al EMISOR
40