RBM - Especificacion Servicio - Boton de Pagos Paga En Linea - v1 6.pdf

Especificación del Servicio Botón de Pagos Paga en Línea Versión 1.6

Último cambio al documento: Enviar comentarios a: Nombre del Documento:

RBM Redeban Multicolor – Servicios Web

05/02/2016 [email protected] Especificación Servicio Botón de Pagos Paga en Línea

Especificación de Servicio Botón de Pagos Paga en Línea Página 1 de 20

Tabla de Contenido 1

PREFACIO ........................................................................................ 3

1.1 1.2

ACERCA DEL DOCUMENTO ....................................................................................... 3 VERSIÓN DEL DOCUMENTO....................................................................................... 3

2

INTRODUCCIÓN ............................................................................... 4

2.1 2.2 2.3

OBJETIVO ............................................................................................................... 4 ALCANCE................................................................................................................ 4 DOCUMENTOS RELACIONADOS ................................................................................. 4

3

DETALLE DE LA ESPECIFICACIÓN ............................................... 5

3.1 WSDL (WEB SERVICES DESCRIPTION LANGUAGE):................................................... 5 3.2 CONEXIÓN CON REDEBAN MULTICOLOR: ................................................................... 5 3.3 DEFINICIÓN DEL SERVICIO ....................................................................................... 6 3.4 MANEJO DE NOTIFICACIONES LIGHTBOX ................................................................... 7 3.5 PRERREQUISITOS .................................................................................................... 9 3.6 POLÍTICAS DE SEGURIDAD DEL SERVICIO ................................................................ 11 3.7 OPERACIONES ...................................................................................................... 11 3.7.1 INICIARTRANSACCIONDECOMPRASOLICITUD ..................................................... 11 3.7.1.1 DEFINICIÓN GENERAL DE LA OPERACIÓN ........................................................... 11 DEFINICIÓN FUNCIONAL .................................................................................................... 12 3.7.1.2 PRECONDICIONES PARA EL FUNCIONAMIENTO DE LA OPERACIÓN ......................... 12 3.7.1.3 POSTCONDICIONES DE EJECUCIÓN DEL SERVICIO .............................................. 12 3.7.1.3.1 MENSAJE DE ENTRADA ................................................................................ 12 3.7.1.3.2 MENSAJE DE RESPUESTA EXITOSO .............................................................. 13 3.7.1.3.3 MENSAJE DE RESPUESTA DE ERROR ........................................................... 14 3.7.1.3.4 MENSAJE DE RESPUESTA DE ERROR TÉCNICO ............................................. 14 3.7.2 CONSULTARESTADODEPAGO ........................................................................... 15 3.7.2.1 DEFINICIÓN GENERAL DE LA OPERACIÓN ........................................................... 15 3.7.2.2 PRECONDICIONES PARA EL FUNCIONAMIENTO DE LA OPERACIÓN ......................... 16 3.7.2.3 POSTCONDICIONES DE EJECUCIÓN DEL SERVICIO .............................................. 16 3.7.2.3.1 MENSAJE DE ENTRADA ................................................................................ 16 3.7.2.3.2 MENSAJE DE RESPUESTA EXITOSO .............................................................. 17 3.7.2.3.3 MENSAJE DE RESPUESTA DE ERROR ........................................................... 17 3.7.2.3.4 MENSAJE DE RESPUESTA DE ERROR TÉCNICO ............................................. 18 3.8 ESPECIFICACIÓN DE CAMPOS ................................................................................. 19

RBM Redeban Multicolor – Servicios Web

Especificación de Servicio Botón de Pagos Paga en Línea Página 2 de 20

1 Prefacio 1.1 Acerca del documento El presente documento contiene la especificación de las operaciones que hacen parte del servicio de Botón de pagos Paga en Línea que es ofrecido por Redeban Multicolor a sus comercios afiliados, el contenido de este documento le permitirá al asociado de Redeban Multicolor conocer los requerimientos necesarios para hacer uso del servicio y entender la mensajería que se intercambiara entre las dos entidades. Este documento se complementa con un archivo tipo hoja de cálculo que contiene los detalles técnicos del servicio.

1.2 Versión del documento Fecha de revisión

Resumen de cambios

Versión

29/08/2013

Versión inicial

1.0

06/09/2013

Corrección de la revisión interna

1.1

17/09/2014

Cambio de ejemplos en mensajes de entrada y respuesta por cambio del WSDL Cambio endpoint ambiente de Producción

1.2

Cambio endpoint por modificación de puerto y aclaración enlace de invocación del botón de pagos Se adiciona en el punto 3.4 la forma de invocar Botón de Pagos desde Internet Explorer Se realiza ajuste en los hipervínculos que referencian la Especificación Técnica del servicio.

1.4

14/10/2014 21/10/2014 11/03/2015 04/02/2016

RBM Redeban Multicolor – Servicios Web

1.3

1.5 1.6

Especificación de Servicio Botón de Pagos Paga en Línea Página 3 de 20

2 Introducción 2.1 Objetivo El documento de especificación del servicio Botón de Pagos Paga en Línea describe las operaciones necesarias para que un Comercio a través de su aplicación pueda interactuar con el sistema Botón de Pagos Paga en Línea para realizar el pago electrónico de una compra, así como la consulta del estado actual de la transacción.

2.2 Alcance En la especificación del servicio Botón de Pagos Paga en Línea se describen las operaciones y flujos que permiten iniciar una transacción de compra en Redeban Multicolor, reutilizar la página de Botón de Pagos Paga en Línea para realizar el pago y finalmente consultar el estado de la transacción. También describe las precondiciones, aspectos de seguridad, conexiones, End Points, y estructura del WSDL del servicio utilizado para el intercambio de información.

2.3 Documentos relacionados Título del Documento Documento de especificación técnica del servicio Botón de Pagos Paga en Línea

Nombre del Documento “REDEBAN MULTICOLOR - RBM Especificación Técnica - GlobalPay v1.1”

RBM Redeban Multicolor – Servicios Web

Descripción Documento donde se especifican cada uno de los campos de las operaciones del servicio.

Especificación de Servicio Botón de Pagos Paga en Línea Página 4 de 20

3 Detalle de la Especificación 3.1 WSDL (Web Services Description Language): La interfaz del servicio expuesto por Redeban Multicolor, se describe de forma técnica utilizando el WSDL incluido a continuación. Al realizar una implementación de un cliente para consumir el servicio, se recomienda utilizar una herramienta de desarrollo que ofrezca la posibilidad de importar este artefacto y a partir de él generar los componentes necesarios para su invocación.

3.2 Conexión con Redeban Multicolor: Para acceder a este servicio desde su plataforma, Redeban Multicolor ha publicado los siguientes dominios: Ambiente Pruebas Pruebas Producción Producción

Descripción www.txstestrbm.com www.pagosrbm.com www.txsprodrbm.com www.pagaenlinearbm.com

Función Llamado al servicio Llamado al botón Llamado al servicio Llamado al botón

Los endpoints del consumo del WSDL los diferentes ambientes son los siguientes: Ambiente Pruebas Producción

Descripción https://www.txstestrbm.com/GlobalPayServicios/GlobalPayServicioDePago https://www.txsprodrbm.com/GlobalPayServicios/GlobalPayServicioDePago

Desde el cual también podrá descargar la última versión del WSDL disponible agregando el sufijo “?wsdl”, así: Ambiente Pruebas

Descripción https://www.pagosrbm.com/GlobalPayServicios/GlobalPayServicioDePago?wsdl

Para la invocación del botón de pagos donde el usuario diligencia los datos personales son los siguientes: Ambiente Pruebas Producción

Descripción https://www.pagosrbm.com/GlobalPayWeb/gp/realizarPago.xhtml?idTerminal=”Termi nal”&idTransaccion=2541393961347885 https://www.pagaenlinearbm.com/GlobalPayWeb/gp/realizarPago.xhtml?idTerminal= ”Terminal”&idTransaccion=2541393961347885

NOTA: Los datos que están resaltados en rojo deben cambiar dependiendo de los datos ingresados tanto mensaje de entrada en el IdTerminal como la respuesta que genera el número del IdTransaccion. A continuación se dará una definición del servicio y un paso a paso del funcionamiento del servicio.

RBM Redeban Multicolor – Servicios Web

Especificación de Servicio Botón de Pagos Paga en Línea Página 5 de 20

3.3 Definición del Servicio Redeban Multicolor ofrece el servicio de Botón de Pagos Paga en Línea a sus comercios asociados con el fin de facilitar un mecanismo ágil y seguro que les permita ofrecer dentro de sus plataformas tecnológicas múltiples medios de pago y gestionar la autorización de estas transacciones a través de la infraestructura que Redeban Multicolor ha consolidado con MasterCard, entidades financieras y otras entidades que actualmente ofrecen medios de pago en Colombia. La solución permite recibir solicitudes de inicio de transacción por parte de los comercios asociados a través de la invocación de un WebService el cual es responsable de generar un id único de transacción que debe ser utilizado por el comercio para abrir la página de pago de Botón de Pagos Paga en Línea, desde está, el usuario (comprador) ingresa su información personal y del medio de pago a utilizar y la envía a Redeban Multicolor.

1. El comercio solicita un ID Transacción a través del servidor 2. El Comercio recibe el ID de la transacción asignado en RBM

3. Un usuario del Comercio realiza el pago sobre la plataforma Botón de Pagos Paga en Línea de RBM 4. Botón de Pagos Paga en Línea procesa la operación y retorna respuesta del pago al cliente

COMERCIOS

5. El usuario cierra la ventana Botón de Pagos Paga en Línea y el sistema notifica al Portal del comercio para que este pueda consultar el estado de la operación

6. El Comercio consulta el estado actual del pago en RBMREDEBAN MULTICOLOR 7. devuelve el estado actual del pago.

El diagrama anterior se detalla así:  1

El comercio reporta la información de la compra invocando desde su servidor el servicio web “iniciarTransaccion” expuesto por REDEBAN MULTICOLOR. Como resultado, este servicio retornará un ID, el cual será utilizado para invocar Botón de Pagos Paga en Línea para que el cliente pueda efectuar el pago. La flecha naranja indica el mensaje de requerimiento hacia Redeban Multicolor de la operación iniciarTransaccion.

RBM Redeban Multicolor – Servicios Web

Especificación de Servicio Botón de Pagos Paga en Línea Página 6 de 20

 2 

3

 4  5  6

El comercio recibe el ID de la transacción con el cual se hará la invocación a Botón de Pagos Paga en Línea. El ID de Transacción es único y se genera a partir de un consecutivo de 7 dígitos más un numero aleatorio dado por el tiempo de la máquina en milisegundos, el consecutivo rota al llegar al número máximo 9,999,999. La flecha verde indica la operación de respuesta de la transacción iniciarTransaccion. Una vez se haya recibido el ID de la transacción, el comercio desde su Portal invocará el URL de Botón de Pagos Paga en Línea con el fin de desplegar un lightbox para que el usuario ingrese la información requerida para realizar el pago. Esta operación se realiza invocando una URL reportando el código de terminal asignado al comercio para Botón de Pagos Paga en Línea y el ID retornado en el paso 2. Ejemplo invocación: www.dominio.com/GlobalPayWeb/gp/realizarPago.xhtml?idTerminal=ESB00011&idTrans accion=01382055146132 La operación se identifica con una flecha naranja. Si el comercio quiere que el botón de pagos muestre solo determinadas tarjetas debe invocar la url de la siguiente forma: www.dominio.com/GlobalPayWeb/gp/realizarPago.xhtml?idTerminal=ESB00011&idTrans accion=01382055146132&fq=MASTERCARD; De esta forma solo mostrará la franquicia Mastercard, para saber cómo debe colocar cada franquicia validar la tabla franquicias que se encuentra en la sección 3.7. El usuario realiza el pago sobre el lightbox del Botón de Pagos Paga en Línea, finalizado el pago, podrá descargar el pagare. Al cerrar el lightbox el Portal del comercio recibirá una notificación (ver punto 3.4) con el fin de realizar el proceso de consulta de estado de la operación. Esta se identifica con una flecha verde y puede ser una respuesta exitosa, error de negocio o cualquier error técnico que se haya producido en el Backend. El comercio realiza una invocación desde su servidor al servicio Web ConsultarEstadoDePago con el fin de verificar el estado actual de una transacción en Redeban Multicolor y la información necesaria del medio de pago utilizado. Esta operación se identifica con una flecha naranja. El comercio recibe la respuesta del estado actual de una transacción. Esta operación se identifica con una flecha verde.

3.4 Manejo de Notificaciones Internet Explorer Para el correcto funcionamiento de Botón de Pagos Paga en Línea, se requiere que se en el momento en se detecte que el explorador es Internet Explorer la invocación sea por medio de una nueva ventana y no por medio del Lightbox, una alternativa es el siguiente código: Código Javasacript var browserIE = false; if(navigator.appName == "Microsoft Internet Explorer") { browserIE = true; } if(browserIE){ $("#boton").click(function(){ iewindow = window.open(url); creacionInterval(); }); }

Para el manejo de notificaciones en Internet Explorer por la naturaleza de la invocación solo se acepta la detección del evento cuando la ventana de Botón de Pagos es cerrada ya sea por el usuario o por el RBM Redeban Multicolor – Servicios Web

Especificación de Servicio Botón de Pagos Paga en Línea Página 7 de 20

aplicativo cuando se cancela o termina la transacción, una alternativa para detectar este evento es el siguiente código: Código Javasacript var ejecucion = false; var timerObjPing; // Funcion la cual verifica si la ventana está cerrada function validarVentana(){ if (iewindow.closed == true && ejecucion == false){ ejecucion = true; alert("Se cerro la ventana"); } } // Funcion en la cual se crea un intervalo de escucha para estar pendiente del cierre de la ventana function creacionInterval(){ timerObjPing = setInterval("validarVentana()",2000); }

3.5 Manejo de Notificaciones Lightbox (otros navegadores) Para el Manejo de las notificaciones en Botón de Pagos Paga en Línea, la aplicación provee el envío de mensajes de tipo “postMessaje” por javascript, estas notificaciones son descritas a continuación: 

Cancelación de la compra: Notificación que se efectúa cuando el usuario no desea continuar con la transacción y oprime el botón de cancelar.



Error en la Transacción: Notificación que se efectúa cuando el usuario no puede continuar con la compra por un error interno del aplicativo y debe salir de este.



Transacción Terminada: Notificación que se efectúa cuando el usuario termina una transacción y quiere volver a la agina del comercio.

Para estas notificaciones el sistema manda respectivamente 3 mensajes en forma de texto plano: 

Cancelación



Error



Finalización

Una alternativa para obtener estos mensajes del lado del servidor del comercio es con el siguiente código: Código Javasacript var eventMethod = window.addEventListener ? "addEventListener" : "attachEvent"; var eventer = window[eventMethod]; var messageEvent = eventMethod == "attachEvent" ? "onmessage" : "message"; eventer(messageEvent,function(e) { alert(e.origin) alert(e.data) },false);

RBM Redeban Multicolor – Servicios Web

Especificación de Servicio Botón de Pagos Paga en Línea Página 8 de 20

Como se ve en el código de ejemplo anterior el mensaje se obtiene en una variable en la cual viene la IP de origen del mensaje y la data la cual contiene los mensajes anteriormente descritos, con esta información podremos gestionar las notificaciones enviadas desde la aplicación.

3.6 Manejo de pantallas móviles Para el correcto funcionamiento del Botón de Pagos Paga en Línea en los dispositivos móviles la forma de invocación se debe hacer en una nueva ventana o tab más no en un lightbox usando en el script my_windod = window.open(url);

Para recibir las notificaciones se deben recibir de un evento que genera la ventana y posteriormente dar cierre a la ventana. Los pasos de la consulta se realizarán igual que en el caso del lightbox invocando la operación de consulta del servicio para saber el estado de la transacción.

3.7 Tabla Franquicias Nombre Franquicia CMRFalabella Codensa sociosbbva JCB PSE Sodexo Alkosto VISA MasterCard AmEx DinersClub Colsubsidio TarjetaExito Serfinanza Bonos Comfama

RBM Redeban Multicolor – Servicios Web

Especificación de Servicio Botón de Pagos Paga en Línea Página 9 de 20

3.8 Prerrequisitos A continuación se describen los requisitos de negocio y técnicos mínimos requeridos para el uso de este servicio. Requisitos de Negocio Condición Verificar la versión del Browser

Invocar la operación IniciarTransaccionDeCompra del Servicio Web GlobalPayServicioDePago

Opción de pago Botón de Pagos Paga en Línea en el Comercio

Descripción Para procesar un pago, el comercio previamente debe verificar la versión del browser del cliente y en caso de ser una versión inferior reportárselo al cliente ya que puede presentarse problemas en el manejo de eventos. Las versiones manejadas son:  Firefox: 17  Chrome: 29  Internet Explorer: 8, 9  Safari: 5  Opera: 16 Para procesar un pago, el comercio previamente debe haber iniciado una transacción de compra en Botón de Pagos Paga en Línea, a través de este inicio de transacción se suministra la información de identificación del comercio, los datos monetarios de la transacción e información opcional que será impresa en el pagare electrónico, y como resultado el Botón de Pagos Paga en Línea entrega un identificador de la transacción que debe ser utilizado por este caso de uso para asociar la información de pago y completar así la información requerida para procesar la transacción en la entidad financiera. El comercio previamente debe habilitar la opción de pago por medio de Botón de Pagos Paga en Línea, tener la capacidad de desplegar la página de compra de Portal enviando el id del terminal que le asigno REDEBAN MULTICOLOR y el id de transacción previamente obtenido por medio de la invocación del servicio de pago.

Requisitos Técnicos Condición Plataforma Ambientes pruebas Validaciones seguridad Certificado Digital (opcional, en caso que el comercio requiera que Redeban Multicolor valide su certificado de seguridad)

RBM Redeban Multicolor – Servicios Web

Descripción Plataforma de desarrollo que soporte Webservices, por ejemplo: Java, .Net, PHP, etc. Ambiente de pruebas independiente del ambiente de producción. Las validaciones de seguridad deben haberse evaluado en Datapower y estar autorizadas. Certificado digital para establecer una conexión a través de SSL (128 bits o superior), este certificado debe ser emitido por una entidad certificadora reconocida, como: Verisign o Certicamara. Si aún no posee un certificado de este tipo y planea adquirir uno para su uso con este servicio a través de una entidad certificado diferente a las mencionadas anteriormente, antes de adquirirlo por favor verifique con RE-

Especificación de Servicio Botón de Pagos Paga en Línea Página 10 de 20

DEBAN MULTICOLOR si el certificado es aceptable.

Adicionalmente y de acuerdo a normas nacionales e internacionales se recomienda: 

No almacenar la información del medio de pago utilizado por el cliente.



Utilizar la menor cantidad posible de puntos de interacción entre la interfaz que captura la información y el punto de invocación al servicio expuesto por REDEBAN MULTICOLOR.

3.9 Políticas de Seguridad del Servicio Se enuncian y describe las diferentes políticas de seguridad que presenta el servicio del Botón de Pagos Paga en Línea.

Principio de Seguridad

Método

Observaciones

Autorización acceso

Se enviara un usuario y contraseña incluidos dentro del mensaje de solicitud. No en el encabezado del servicio.

Previamente el comercio debe solicitar su registro y autorización ante Redeban Multicolor

3.10 Operaciones Un servicio integra un conjunto de operaciones. A continuación se describirán las operaciones que componen el servicio GPServicios. Como se había mencionado anteriormente, para que un comercio pueda realizar el pago deberá iniciar primero una transacción de compra. Esta transacción de compra puede ser consultada una vez se haya hecho el proceso de pago correspondiente. A continuación se detallan cada una de estas operaciones junto con su mensajería.

3.10.1

IniciarTransaccionDeCompraSolicitud

3.10.1.1 Definición General de la Operación Nombre Operación Nombre del Archivo que Define especificación técnica de la operación Objetivo de Negocio de la Operación Política de Reintentos

TimeOut

RBM Redeban Multicolor – Servicios Web

IniciarTransaccionDeCompraSolicitud RBM - Especificación Técnica – Boton de Pagos Paga en Líneav1.0.xls hoja IniciarTransaccionDeCompra e IniciarTransaccionDeCompraResp. Inserta en la Base de datos de registro de transacciones la información que enviará el comercio referente al pago, genera un identificador de la transacción y lo entrega al comercio para el inicio de la página de pago a través de Botón de Pagos Paga en Línea. Cada vez que el comercio inicie una transacción de compra a través del servicio este generara un ID de transacción único independiente de los datos del comercio, por lo tanto en caso de falla en el consumo del servicio el comercio podrá invocar nuevamente el servicio utilizando los mismo datos. 10 segundos

Especificación de Servicio Botón de Pagos Paga en Línea Página 11 de 20

Definición Funcional 3.10.1.2 Precondiciones para el Funcionamiento de la Operación Condición

Descripción

Validaciones de seguridad

El comercio deberá estar registrado y autorizado por Redeban Multicolor para poder iniciar una transacción. El comercio debe invocar los servicios a través de protocolo HTTPS desde su servidor invocando el Web Service que Redeban Multicolor le suministre.

3.10.1.3 Postcondiciones de Ejecución del Servicio Condición Generación Id_transaccion y adición registro nuevo a la Base de Datos

Descripción El servicio genera un ID único por transacción compuesto por un consecutivo de 7 dígitos y la hora del sistema en milisegundos.

A continuación se presentan algunos mensajes de ejemplo a la mensajería expuesta por el servicio de IniciarTransaccionDeCompraSolicitud, para determinar el valor de cada elemento o campo por favor refiérase al documento de especificación técnica asociado.

3.10.1.3.1 Mensaje de entrada A continuación se presenta un escenario exitoso donde el Comercio solicita un Id de transacción terminal. El detalle y descripción de esta mensajería se puede encontrar en el documento RBM - Especificación Técnica - GlobalPay - v1.1.xlsx Pepito Perez 12345678 GlobalPay ESB00001 80091215 RBM Redeban Multicolor – Servicios Web

Especificación de Servicio Botón de Pagos Paga en Línea Página 12 de 20

037 123456 19952.00 IVA 1500.00 1234.00 MontoAdicional 355.00 Comercio A Comercio-Redeban Multicolor

3.10.1.3.2 Mensaje de Respuesta Exitoso Mensaje como respuesta exitosa. Se genera un Id de Transacción con el cual un usuario del comercio invocará el Botón de Pagos Paga en Línea. El detalle y descripción de esta mensajería se puede encontrar en el documento RBM - Especificación Técnica - GlobalPay - v1.1.xlsx GlobalPay ESB00001 00123456789 20023

RBM Redeban Multicolor – Servicios Web

Especificación de Servicio Botón de Pagos Paga en Línea Página 13 de 20

00 Transaccion Exitosa ? 1234567890

3.10.1.3.3 Mensaje de Respuesta de Error Este mensaje de error se puede presentar cuando no se envía algún campo en el XML que es requerido o si un tipo de dato no es válido según lo definido en el WSDL El detalle y descripción de esta mensajería se puede encontrar en el documento RBM - Especificación Técnica - GlobalPay - v1.1.xlsx 9003 Error en validacion de estructura

Rechazado

3.10.1.3.4 Mensaje de Respuesta de Error Técnico Este mensaje de error se puede presentar cuando no hay comunicación con el backend o entidad proveedora del servicio. El detalle y descripción de esta mensajería se puede encontrar en el documento RBM - Especificación Técnica - GlobalPay - v1.1.xlsx GlobalPay ESB00001 123456789 2009

RBM Redeban Multicolor – Servicios Web

Especificación de Servicio Botón de Pagos Paga en Línea Página 14 de 20

9002 Aplicacion No Disponible Rechazado

Códigos para errores Técnicos que responde la consulta de este servicio Web.

Código de respuesta 9002

Descripción

Estado

Aplicación No Disponible

Rechazado

9003 9004 9006 9008

Error en validación de estructura Ha ocurrido un error no esperado en el servicio WEB Se encontró un valor mayor del esperado en el Identificador de la transacción (idTransaccionTerminal) esta duplicado para la fecha.

Rechazado Rechazado Rechazado Rechazado

3.10.2

ConsultarEstadoDePago

3.10.2.1 Definición General de la Operación

Nombre Operación

ConsultarEstadoDePago

Nombre del Archivo que Define especificación técnica de la operación Objetivo de Negocio de la Operación

RBM - Especificación Técnica - GlobalPay - v1.1.xlsx hoja ConsultarEstadoDePago - ConsultarEstadoDePagoResponse

Política de Reintentos TimeOut

Al ser invocada la operación ConsultarEstadoDepago, el sistema consulta el registro de transacciones para obtener el estado de la transacción solicitada. El comercio puede invocar varias veces el servicio para determinar su estado sin que se altere. 10 Segundos

Para consultar el estado del proceso de compra, se invoca el servicio de consulta con la misma información enviada para la operación de inicioTransaccion adicionando el “idTransaccionActual” retornado en la respuesta. Todos los campos deben concordar para que esta sea encontrada sobre el Log de transacciones.

Condición

Descripción

Validaciones de seguridad

El comercio deberá estar registrado y autorizado por Redeban Multicolor para poder iniciar una transacción. El comercio debe invocar los servicios a través de protocolo HTTPS desde su servidor invocando el Web Service que

RBM Redeban Multicolor – Servicios Web

Especificación de Servicio Botón de Pagos Paga en Línea Página 15 de 20

Ambientes

Redeban Multicolor le suministre. La base de datos y el Portal de pagos deben estar disponibles. Se requiere ambientes de pruebas y producción. Se validará en su momento si el comercio tiene ambiente de certificación o calidad.

3.10.2.2 Precondiciones para el Funcionamiento de la Operación Condición

Descripción

Validaciones de seguridad

El comercio deberá estar registrado y autorizado por Redeban Multicolor para poder iniciar una transacción. El comercio debe invocar los servicios a través de protocolo HTTPS desde su servidor invocando el Web Service que Redeban Multicolor le suministre.

3.10.2.3 Postcondiciones de Ejecución del Servicio Condición Generación Id_transaccion y adición registro nuevo a la Base de Datos

Descripción Debe existir un registro de Transacción para poder realizar una consulta. Debe existir un tipoTerminal, idTerminal, idAdquiriente, idTransaccionTerminal para poder realizar una consulta de la transacción.

A continuación se presentan algunos mensajes de ejemplo a la mensajería expuesta por el servicio de ConsultarEstadoDePago, para determinar los valores para cada elemento o campo, por favor refiérase al documento de especificación técnica asociado.

3.10.2.3.1 Mensaje de entrada A continuación se presenta un escenario exitoso donde el Comercio consulta el estado de una transacción. El detalle y descripción de esta mensajería se puede encontrar en el documento RBM - Especificación Técnica - GlobalPay - v1.1.xlsx GlobalPay ESB00002 12345678

RBM Redeban Multicolor – Servicios Web

Especificación de Servicio Botón de Pagos Paga en Línea Página 16 de 20

204 12341412805722540

3.10.2.3.2 Mensaje de Respuesta Exitoso A continuación se presenta la respuesta en un escenario exitoso donde el Comercio consulta el estado de una transacción. En este ejemplo se muestra su estado, una descripción y un código “00” que representan dicho escenario adicional de los campos de que hacen eco del mensaje de entrada. El detalle y descripción de esta mensajería se puede encontrar en el documento RBM - Especificación Técnica - GlobalPay - v1.1.xlsx GlobalPay ESB00002 12345678 204 MASTERCARD Credito 2014-10-08T17:06:39.000-05:00 400995 16000 0 204 00 Transaccion exitosa Iniciada

3.10.2.3.3 Mensaje de Respuesta de Error Este mensaje de error se puede presentar cuando no se envía algún campo en el XML que es requerido o si un tipo de dato no es válido según lo definido en el WSDL

RBM Redeban Multicolor – Servicios Web

Especificación de Servicio Botón de Pagos Paga en Línea Página 17 de 20

El detalle y descripción de esta mensajería se puede encontrar en el documento RBM - Especificación Técnica - GlobalPay - v1.1.xlsx

9003 Error en validacion de estructura

Rechazado

3.10.2.3.4 Mensaje de Respuesta de Error Técnico Este mensaje de error se puede presentar cuando no hay comunicación con el backend o entidad proveedora del servicio. El detalle y descripción de esta mensajería se puede encontrar en el documento RBM - Especificación Técnica - GlobalPay - v1.1.xlsx GlobalPay ESB00001 123456789 2009 9002 Aplicacion No Disponible ErrorConsulta Códigos para errores Técnicos que responde la consulta de este servicio Web.

Código de respuesta 9001

Descripción

Estado

El número de transacción no existe

Rechazado

9003

Error en validación de estructura

Rechazado

RBM Redeban Multicolor – Servicios Web

Especificación de Servicio Botón de Pagos Paga en Línea Página 18 de 20

9002

Aplicación No Disponible

Rechazado

9004

Ha ocurrido un error no esperado en el servicio WEB

Rechazado

3.11 Mensaje de Error Valor

00 01 02 03 05 08 12 13 14 19 25 30 31 41 43 45 48 49 50 51 54 55 57 58 61 62 65 66 67 68 69 71 72 73 74 75 76 77 78 79 80

Estado Aprobado Rechazado Rechazado Rechazado Rechazado Aprobado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado

Descripción Aprobado Llame al Emisor Llamar REF Marca No Habilitada Rechazo General Aprobado Transaccion Invalida Monto Invalido Tarjeta Invalida Reinicie Transaccion No Existe Comproban Formato Invalido Tarjeta No Soportada Retenga Y Llame Retenga Y Llame Requiere cambio de PIN Usuario no autorizado Terminal Invalida Operador no responde Fondos Insuficientes Tarjeta Vencida PIN Invalido Transacción No Permitida Terminal No Habilitado Excede Monto Limite Tarjeta Uso Restringido Excede Uso Dia Bono No Habilitado Bono Bloqueado Bono Vencido Bono Ya Habilitado Factura no existe Factura ya pagada HISO Factura vencida HISO Cedula Invalida HISO Excede Intentos PIN Llamar/Error - DC Error En Cierre Cargo No Encontrado Lote Ya Abierto Factura No Existe POS

RBM Redeban Multicolor – Servicios Web

Especificación de Servicio Botón de Pagos Paga en Línea Página 19 de 20

81 82 83 84 85 86 87 89 91 92 94 95 96 97 98 B1 B2 B3 B4 B5 B6 B7 B8 SD

Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado Rechazado

Factura Ya Pagada POS Factura Vencida POS Servicio No Permitido Tarj. No Autorizada Factura No Pagada Cuenta Invalida Excede Monto Diario Nro. Terminal Invalido Entidad no responde/disponible Cancelado por Usuario Transacción duplicada Espere Transmitiendo Transacción no puede ser procesada No Existe Pre-Autorización Pre-Autorizacion Vencida Convenio No existe Convenio No asociado al comercio Convenio No permite Recargas de Bonos Tarjeta no Asociada al Convenio selecci onado Prefijo de Tarjeta destino no asociada al Convenio seleccionado Supera el numero maximo de transacciones diarias Supera el valor maximo de la transaccion Tarjeta Matriz No existe ESP sin Base de Datos Rechazo General

3.12 Especificación de campos Para ver el detalle de la especificación de campos referirse al documento RBM - Especificación Técnica - GlobalPay - v1.1.xlsx

RBM Redeban Multicolor – Servicios Web

Especificación de Servicio Botón de Pagos Paga en Línea Página 20 de 20