Recarga HTML
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 la tienda online 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.
Flujo#
La tienda inicia el flujo predeterminado después de que el comprador completa la compra:
La tienda debe iniciar la transacción con Portal Carat enviando los datos de compra a través del [servicio de creación de transacciones] (pagamento-html-begin.md).
El flujo de recarga consta de los siguientes pasos:
- Después de que el comprador finalice 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 de todos los parámetros necesarios. Más información
- En respuesta al POST, la tienda recibirá una URL de Portal Carat a la que el comprador debe ser redirigido. Esta URL será diferente para cada transacción de recarga.
- El comprador seleccionará los datos de la recarga, como concesionario/operador, ddd y el valor de la recarga, y verá los datos asociados a este valor, como la validez, la bonificación, etc.
- Después de esto, el comprador procederá con el flujo de pago, seleccionando el pago entre los disponibles para la tienda.
- En el último paso del pago, se realizarán las operaciones de pago y recarga, en el autorizador y en el concesionario/operador, respectivamente, en este orden.
- Al final del flujo, el Portal Carat redirigirá al comprador de vuelta a la tienda, según la configuración de las URL´s de retorno ya registradas en la tienda, o a las back_url´s (ver Tabla 1) enviadas al crear las transacciones.
Para cada alteração de status da transação de pagamento no Pagamento Online, a loja receberá um POST de aviso de status, informando a situação da mesma. Saiba mais.
Todas las llamadas realizadas serán atendidas sincrónicamente, excepto la notificación de Status que se realizará mediante Portal Carat de forma asincrónica.
Iniciar una transacción de recarga#
Para iniciar una recarga de HTML, consulte la documentación de [quickstart] (recarga-html-quickstart.md).
Realización de una transacción de recarga#
Al acceder a la URL devuelta por el [servicio de creación de transacciones] (pagamento-html-begin.md), se devolverá la pantalla de selección del valor de recarga, como se muestra en la siguiente figura:
