Integracin de Wallet

Especificaciones de Integracin para el

Comercio

Versin: 1.0 (30 de septiembre de 2015)

Contenido
I.

HISTORIAL DE VERSIONES...............................................................................

II. ESPECIFICACIONES PARA INTEGRACIN DEL COMERCIO................................

1.

Forma de Integracin....................................................................................

2.

Operaciones.................................................................................................

3.

Descripcin de los mensajes XML de entrada y salida........................................

3.1

Registro de Tarjetahabiente..............................................................

I. Historial de Versiones
La siguiente tabla describe la historia de modificacin del documento para
propsitos de seguimiento. nicamente los cambios que produzcan una nueva
versin debern ser mostrados en estas tablas.

Versin
1.0

Fecha

Modificaciones

20-11-2013 Desarrollo inicial del documento

Modificado
por
Juan Diego
Camino

II. Especificaciones para integracin del Comercio

En el presente documento se especificar como se integrar el Sistema Wallet y el
Comercio. Para ello, primero se describir la forma de integracin (Web Services),
las operaciones que se pueden realizar y los parmetros que estas requieren.

1. Forma de Integracin
La forma de integracin utilizada entre las plataformas del Comercio y Wallet es a
travs de Web Services, que incorporan protocolos de seguridad adicionales. Este
Web Service publicara el siguiente servicio con los atributos:
Atributo
Parmetros de

Valor
xmlOpe (Cadena)

Entrada
Parmetros de

Descripcin
Es el mensaje XML principal que
indica que operacin se desea

xmlResp (Cadena)

Salida

realizar
Es el mensaje XML que contiene el
resultado de realizar la operacin
solicitada en xmlOpe

Especificaciones adicionales se describen en el archivo wsdl correspondiente al

servicio. Adicionalmente el parmetro de entrada xmlOpe y el parmetro de salida
xmlResp son descritos en detalle en el punto 3 del presente documento.

2. Operaciones
Las operaciones son aquellos servicios que ofrece Wallet a los Comercios asociados,
las operaciones que estn disponibles para ser solicitadas son las siguientes:

Registro de tarjetahabiente

Cabe recalcar que estas operaciones se solicitan dentro del parmetro de entrada
xmlOpe, el cual se describe en el siguiente punto.

3. Descripcin de los mensajes XML de entrada y salida

Como se mencion antes, la solicitud de realizacin de una operacin a Wallet se
hace a travs del parmetro de entrada xmlOpe, asimismo el resultado de realizar
la operacin se devuelve a travs del parmetro de salida xmlResp; tanto la
solicitud como el resultado son mensajes XML, estos XML tiene una estructura
determinada para cada operacin, esta estructura se describe para cada una a
continuacin:
Leyenda
Parmetro
* = indica valor
obtenido del POS

Tipo de Dato
A = Alfabtico
N = Numrico
AN = Alfanumrico
F= Fecha
H=Hora
FHM=Fecha, Hora, Milis.

Lon.
* = indica que
la longitud
puede variar
X= indica X
decimales

Descripcin
* = Opcional

3.1

Registro de Tarjetahabiente

Descripcin de Entrada:
Parmetro
identComercio
codTarjetahabiente
tipoOperacion
nom
ape
correo

Tipo de Dato
Cadena (N)
Cadena (AN)
Cadena (AN)
Cadena (AN)
Cadena (AN)
Cadena ()

Lon.
4
10
1
30 (*)
30 (*)
50 (*)

Descripcin
Es el cdigo de servicio designado para el Comercio.
Cdigo del tarjetahabiente (manejado por el comercio)
Tipo de operacin (R-Registro A-Actualizacin)
Primer nombre del tarjetahabiente
Primer apellido del tarjetahabiente
Correo del tarjetahabiente

Tipo de Dato
Cadena
Cadena
Cadena (N)
Cadena (F)
Cadena (H)

Lon.
7
50
10 (*)
8
8

Descripcin
Cdigo de respuesta de la operacin solicitada
Descripcin del cdigo de respuesta
Cdigo nico del tarjetahabiente asignado por Wallet
Fecha de operacin
Hora de la operacin

Descripcin de Salida:
Parmetro
codRespuesta
descRespuesta
codThWallet
fecha
hora