SISTEMA DE RECARGAS INPEC

Especificación Técnica de Web Services

1. INTRODUCCIÓN
Por medio del siguiente documento se especifica técnicamente el funcionamiento del Web
Services de Consulta y Respuesta de Recaudo para el Sistema de Recargas de INPEC.

2. DEFINICIÓN DE WEB SERVICES

2.1 Web Service “Consulta de Pago”
- Descripción Funcional
Permite realizar la consulta del pago por medio del método consultarRecaudo().
- Estructura de Datos
Respuesta
Campo Tipo Descripción Requerido
ciudad String Ciudad origen del pago X
created_ad timestamp Fecha de creación del registro X
idbenefactor String Identificación de la persona que realiza el
X
pago
idbeneficiario String Identificación de la persona a la que se le
X
realizará la recarga
idrecaudo String Identificador único para el recaudo X
log String IP del equipo origen de la recarga X
pin String Identificador del beneficiario de la
X
recarga
td String Tipo de Documento del beneficiario X
telefonosms String Número telefónico del benefactor que
X
realizó el pago
valor String Valor del pago X

2.2 Web Service “Notificación de Pago”

- Descripción Funcional
Notifica el pago y envía los datos necesarios para realizar la recarga por medio
del método recargarMinutos().
- Estructura de Datos
Envío
Campo Tipo Descripción Requerido
Idbenefactor String Identificación de la persona que realiza
X
el pago
Idbeneficiario String Identificación de la persona que
X
realizará la recarga
Idrecaudo String Identificador único para el recaudo X
Pág. 1
 SISTEMA DE RECARGAS INPEC

pin String Identificador del beneficiario de la

X
recarga
td String Tipo de Documento del beneficiario X
Telefonosms String Número telefónico del benefactor que
X
realizó el pago
Valor String Valor del pago X
Ciudad String Ciudad origen del pago X
codigotransaccion String Dato único que identifica la
X
transacción en pagos inteligentes
Formapago String Tipo de forma de pago utilizada en la
transacción (virtual, efectivo, cheque o X
mixto)
franquicia String Franquicia desde la cual se realizó el
recaudo (medios que tengan convenios X
con pagos inteligentes, éxito, jumbo)
descripcion String Descripción del recaudo realizado X
Referencia1 String Código de referencia con la cual se
X
realizó el recaudo
fechapago String Fecha y hora en que se realizó el
X
recaudo. Formato: aaaa/mm/dd
recibopago String Dato que identifica la transacción
X
cuando son pagos virtuales
codigo String Identificador asociado al estado del
recaudo.
0000 – Exitoso X
0426 - Referencia no válida
0532 - Credenciales no válidas
Mensaje String Mensaje asociado al estado de
X
acuerdo con el código que se envía.

Pág. 2
SISTEMA DE RECARGAS INPEC

Pág. 3