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.