Checkout Web

Descripción general#

Portal Carat dispone de dos interfaces de integración con la tienda online, POST / HTML y Web Services (REST), que permiten a la tienda interactuar con el Portal Carat de forma adecuada, dependiendo del idioma y plataforma de ejecución de la tienda online.

La interfaz HTML se definió como una forma sencilla y rápida de integrarse con los métodos y servicios de pago que existen en Portal Carat, pero sin perder flexibilidad. La interfaz estándar tiene solo dos parámetros obligatorios, recopilando los demás en el propio portal o mediante la configuración realizada por el administrador de la tienda en la parte posterior de Portal Carat, sin embargo, si la aplicación de la tienda virtual desea pasar definiciones o restricciones para un cierto tipo de servicio, red o incluso número de cuotas, esto se puede hacer a través del conjunto de parámetros pasados ​​al inicio de la transacción, antes de la redirección del cliente.

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

Flujo#

La tienda ejecuta el flujo de pago después de que el comprador completa la compra.

La tienda debe iniciar la transacción con Portal Carat enviando los datos de la compra a través del [servicio de creación de transacciones] (pagamento-html-begin.md).

El flujo de pago sin redireccionamiento consta de los siguientes pasos:

  1. Luego de que el comprador completa la compra, la tienda crea una nueva transacción en Portal Carat, a través de un POST en la URL para iniciar una transacción, informando todos los parámetros necesarios. [Más información] (pagamento-html-begin.md)
  2. En respuesta al POST, la tienda recibirá una URL de Portal Carat la que se debe redirigir al comprador. Esta URL será diferente para cada transacción de pago.
  3. El comprador procederá con el flujo de pago según el autorizador informado, y finalizará el pago.
  4. Al finalizar el flujo de pago, Portal Carat redirigirá al comprador de regreso a la tienda, de acuerdo con la configuración de las URL de devolución ya informadas en el registro de la tienda, oa las back_url ([saber más] (pagamento-html-begin.md)) enviado al crear la transacción de pago.

Por cada cambio en el estado de la transacción de pago en Portal Carat, la tienda recibirá un aviso de status POST, informando el estado de la misma. [Más información] (pagamento-html-avisostatus.md)

Todas las llamadas realizadas serán atendidas sincrónicamente , excepto la notificación de estado que se realizará mediante Portal Carat de forma asincrónica .

El Portal Carat permite a la tienda configurar el método de pago responsable de autorizar las transacciones de una determinada marca. Por ejemplo, una tienda puede preferir que las transacciones con tarjeta VISA se enruten a través de CIELO mientras que las transacciones con tarjeta Mastercard se enruten a través de RED.

Esta flexibilidad para configurar el enrutamiento le da a la tienda la posibilidad de manejar promociones según la marca de la tarjeta.

Pensando en cómo evitar que un usuario seleccione la marca VISA, pero termina informando el número de una tarjeta Mastercard, Portal Carat brinda un mecanismo de verificación e intercambio de la autoridad autorizante que será responsable para la autorización de la transacción.

[Más información] (authorizadoras.md)

Pago sin redireccionar al comprador#

La siguiente figura ilustra el flujo de pago HTML 2.0 sin redirigir al comprador a un entorno fuera del Portal Carat. Como ejemplo, tenemos pagos vía SiTef, e-Rede, entre otros.

![](assets / payment-html-flow-without-redir.png)

Pago que redirige al comprador al Autorizador#

La siguiente figura ilustra el flujo de pago HTML 2.0 utilizando un autorizador que requiere que el comprador redirija a su sistema (ejemplo: PayPal, Banco do Brasil, MercadoPago, entre otros).