Skip to main content
Adapta el checkout a tu marca y a los dispositivos de tus clientes. La disponibilidad depende de la versión de la librería y de las funciones habilitadas para tu comercio.

Dónde se configuran

Estas mejoras se ven según la versión del componente y la configuración enviada al inicializar Flex. Si tu comercio ya tiene Flex activo, revisa esta tabla para saber qué debes añadir o validar en tu integración.
Envía explícitamente display_settings.methods con los métodos habilitados que quieras mostrar, por ejemplo CARD o YAPE, para mantener una configuración predecible.
El logo configurable no se envía dentro del objeto de inicialización. Para habilitarlo, el comercio debe compartir con el equipo de integraciones una URL pública HTTPS del logo que se mostrará en el checkout.

Detalle por mejora

Logo configurable

  • Permite personalizar el logo que aparece en la parte superior izquierda del checkout.
  • El comercio debe compartir la URL pública HTTPS del logo que desea mostrar.
  • La URL debe apuntar directamente al archivo de imagen y estar disponible sin autenticación.
  • La activación se coordina con el equipo de integraciones; no se configura desde settings, display_settings ni i18n.
  • Selector de idioma visible dentro del checkout.
  • Soporte inicial para ES y EN.
  • Ayuda a comercios con compradores que prefieren una experiencia bilingüe.
  • Se configura en Inicializar el componente, dentro del objeto i18n.
  • Botón de cierre más visible en la interfaz.
  • Permite salir del checkout sin ambigüedad.
  • Mejora el control del usuario durante el proceso de pago.
  • Se activa con settings.show_close_button en Inicializar el componente.
  • Tarjeta renderizada de forma más visual.
  • Logos de marca visibles cuando corresponda.
  • Campos principales organizados para facilitar la lectura.
  • Revisa CARD en display_settings.methods y los datos enviados en Construcción del payload.
  • Bordes redondeados en contenedores y campos.
  • Separación visual más clara entre métodos de pago y formulario.
  • Apariencia más limpia y consistente entre flujos.
  • Se controla con settings.show_border en Inicializar el componente.
  • Pantalla de Yape más directa.
  • Campo de celular y código de aprobación mejor diferenciados.
  • Mensajes de ayuda orientados a reducir errores del comprador.
  • Revisa que YAPE esté habilitado en display_settings.methods y usa Datos de prueba para validar el flujo.
  • El checkout muestra el número de operación asociado al pago.
  • Facilita trazabilidad para soporte, conciliación y revisión operativa.
  • Ayuda al comercio y al comprador a identificar el intento de pago.
  • Se activa con settings.show_operation_number en Inicializar el componente.

Comportamiento responsive

Flex conserva su estructura interna mientras el contenedor externo calcula una escala adecuada para el viewport.

Web

Mantiene la escala original cuando el formulario cabe en la ventana.

Celular

Reduce el formulario proporcionalmente para evitar cortes horizontales.

Contenido dinámico

Recalcula la altura cuando Flex cambia de paso o método de pago.

Ejemplo de implementación

Este ejemplo visual usa una presentación popup. La inicialización, los callbacks y el desmontaje descritos más adelante también aplican a las presentaciones embebida y expandida.

Antes de publicar

Comprueba el componente en estos escenarios:
Los callbacks no reemplazan la confirmación del pago desde backend. Continúa con la guía de callbacks para interpretar el resultado.

4. Resultados y cierre

Interpreta callbacks, confirma el pago desde backend y desmonta el formulario.