Descripcción General

Introducción#

Las formas habituales para la consulta del estado de la transacción y el manejo de transacciones pendientes requieren el uso de informes de SiTef® o SiTef-Conciliação.

Estas opciones no permiten la automatización de operaciones.

Para solucionar este problema, se creó un servicio de consulta y resolución de disputas on-line(en línea), que será accedido por un "App Server" (desarrollado por integrador/cliente) permitido de listado, status validación y resolución de transacciones pendientes del SiTef-Conciliação.

El WebService utiliza un servidor de aplicaciones basado en Jetty, responsable de atender las solicitudes HTTPS. En este servidor, los servicios para manejar problemas pendientes y verificar el estado de transacción vía protocolo REST. Para la autenticación y autorización, se utiliza el protocolo Basic Authentication (utilizando el inicio de sesión del usuario en el SiTef-Conciliação) para cada solicitud.

Objetivo#

Esta documentación tiene como objetivo presentar la definición de interfaces y criterios técnicos necesarios para uso de WebService de Consulta.

Público-objetivo#

Esta documentación está destinada al integrador / equipo de desarrollo del cliente, o cualquier interesado en utilizar el servicio de Consulta y resolución pendiente de transacciones.

Advertencia#

Este proceso disponible de confirmar o deshacer una transacción TEF permite que las transacciones tienen su status cambiado en el servidor SiTef®.

El efecto de este cambio en la red adquirente dependerá de la regla comercial adoptada por cada red. Por ejemplo, tenemos redes que realizan cualquier transacción pendiente al tercer día, otras redes cancelan una transacción de débito si no se efectúa en el mismo día. También tenemos redes donde una transacción no se resuelve en el momento de la venta, el cambio dependerá de un mensaje que se origine en la red adquirente, este mensaje lo llamamos sonda.

Por lo tanto, para que este proceso sea efectivo, sugerimos realizar este proceso al menos una vez al dia.