Descripción general

La preautorización es una transacción cuyo valor se reservará del límite de la tarjeta, pero no se debitará de inmediato, y puede capturarse posteriormente por un monto igual o menor al monto autorizado. El plazo de captura, así como la posibilidad de capturar cantidades menores, depende de la negociación con la red adquirente /enrutador, siendo la Tienda Virtual la responsable de consultar a la red adquirente/enrutamiento.

La preautorización se utiliza en los casos en que será necesario capturar la transacción después de un largo período de tiempo. Por lo tanto, solo es posible autorizar una transacción de pago y confirmarla /capturarla en un día posterior. La diferencia entre un pago con confirmación posterior y una preautorización con captura es el período de tiempo en el que se puede realizar la transacción.

El período permitido para realizar la confirmación / captura de una preautorización es mayor que un pago con confirmación posterior. Para una mejor comprensión, podemos mencionar los siguientes ejemplos de aplicaciones:

Una empresa de alquiler de coches autoriza un pago para un cliente. La empresa capturará/confirmará la transacción solo cuando el cliente devuelva el coche, lo que puede demorar muchos días. En este escenario, se recomienda utilizar una transacción de preautorización.

Una tienda autoriza un pago, pero antes de confirmar/capturar la transacción, consulta las existencias para comprobar la disponibilidad de un método de pago, lo que podría llevar varios minutos u horas, y luego realiza el pago. En este escenario, sería recomendable utilizar una operación de pago ordinaria con confirmación posterior.

Y para saber más sobre estas nomenclaturas (Bin, Software Express, Carat, e-Sitef) Leer más

Comunicación

Para realizar una transacción de Web Service, todas las comunicaciones se realizarán a través de HTTPS/TLS. Es importante que el servidor del comerciante soporte la criptografía con al menos 128 bits y el protocolo TLS 1.2 . El servidor de la tienda debe realizar llamadas a direcciones específicas para transacciones REST.

Se debe llamar a cada servicio utilizando la URL base concatenada del recurso deseado (ver el capítulo referente al servicio que se va a consumir). El método HTTP (GET, POST o PUT) indica la acción esperada en el recurso elegido. Abajo están las URLs de base del Portal Carat:

URL del entorno de certificación/prueba:

https://esitef-homologacao.softwareexpress.com.br/e-sitef/api/

URL del entorno de producción:

https://esitef-ec.softwareexpress.com.br/e-sitef/api/

Atención : Nunca use la IP en lugar del dominio esitef-ec.softwareexpress.com.br, porque la IP puede cambiar en cualquier momento y sin previo aviso, por lo que es Es importante utilizar el dominio para acceder al Portal Carat.

Importante : Además de los parámetros de respuesta del webservice descritos en este especificación, Portal Carat puede devolver otros parámetros sin previo aviso. ES importante que la aplicación esté preparada para recibir parámetros extras además del los parámetros ya especificados y simplemente deséchelos.

Flujo

El flujo de preautorización será iniciado por la Tienda Virtual cuando la aplicación envíe la operación beginTransaction, en respuesta a la solicitud la aplicación recibirá el nit y otros parámetros.

Descripción de flujo:

1. Al iniciar la operación beginTransaction por la tienda virtual, se devuelve un nit (identificador de transacción) y otros parámetros;
2. La tienda virtual luego procede a consumir doPreAuthorization, el servicio de preautorización, pasando el nit y los demás parámetros recibidos. Si tiene éxito, la transacción de preautorización cambiará su estado a CON (transacción confirmada).
3. Posteriormente (de acuerdo con la regla de negocio) el mismo nit enviado en la preautorización debe enviarse en la operación capture junto con otros parámetros y debe tratar los parámetros recibidos en el webservice response.