> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://academy.zrupay.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Crear y gestionar Checkouts

# ¿Qué es un Checkout?

Un **Checkout** es la pantalla de pago que ven tus clientes cuando están a punto de pagar. Cada checkout puede:

- **Mostrar diferentes métodos de pago** (tarjeta, Bizum, PayPal, criptomonedas, etc.)
- **Mostrarse solo a ciertos clientes** según reglas de segmentación (país, idioma, tipo de dispositivo, moneda...)
- **Tener su propia apariencia** mediante temas reutilizables
- **Conectarse a Conexiones u Orquestaciones** para procesar el pago

La cadena conceptual es:

> **Checkout** → contiene **Métodos** → cada método se asigna a una **Conexión** o a una **Orquestación** que decide cómo procesar el pago.

# Cómo localizar y gestionar tus Checkouts

En el panel: menú lateral → bloque **Optimización** → **Checkouts**.

## El listado

El listado tiene dos pestañas: **Activos** y **Desactivados**, y dos modos de visualización:

- **Vista cuadrícula**: cada checkout se muestra como una tarjeta con un preview real de la pantalla de pago (mockup con monto, métodos y formulario), su nombre, los iconos de los métodos activos y un badge con el condicionante de segmentación.
- **Vista lista**: tabla con columnas Nombre, Métodos de pago, Mostrar para y Última modificación.

## Crear un Checkout

Haz clic en el botón **"Crear Checkout"** arriba a la derecha. Se abrirá directamente el editor con un checkout nuevo en blanco listo para configurar.

# El editor de Checkouts

Al entrar en el detalle de un Checkout (o al crear uno nuevo) se abre el **editor en split-view**. La pantalla se divide en tres zonas:

- **Cabecera superior**: flecha para volver al listado, fecha de última actualización, nombre del checkout con su desplegable y botón **Publicar**.
- **Sidebar izquierdo** con cuatro pestañas verticales: Segmentación, Métodos, Apariencia, Configuración.
- **Panel derecho** con un preview en vivo del checkout que se actualiza con cada cambio.

> 🧐 El checkout no se activa ni se desactiva desde la cabecera. Eso se hace desde la pestaña **Configuración**, con **Activar checkout**.

# Pestaña 1: Segmentación

Define **a quién se le mostrará este checkout**. Útil cuando tienes varios checkouts y quieres que cada uno aparezca en condiciones distintas (por ejemplo, uno para España y otro para LATAM).

## Cómo funciona

La sección se titula **Segmentación del checkout**, y dentro, bajo la etiqueta **"Mostrar a:"**, añades las condiciones que se evalúan al mostrar el checkout. Se añaden con **Añadir condición**.

- Si es el checkout **predeterminado**, no puedes segmentarlo. El panel lo indica así: "Los checkouts predeterminados no se pueden segmentar y se utilizan únicamente cuando no se cumplen los requisitos de segmentación de los checkouts personalizados".
- Si añades una variable, el checkout solo se muestra cuando esa variable se cumple.
- Puedes añadir varias variables; todas se evalúan en AND.

## Variables disponibles (18)

**Operación (9):** Precio, Moneda, Tipo (Pago único / Suscripción / Autorización), Idioma, Solo autorizar el pago, MOTO, Aprobación parcial, POS, Terminal POS.

**Cliente (9):** Variable personalizada, Tipo de dispositivo, Sistema operativo, Navegador, País IP, Región IP, País, Región, Email.

# Pestaña 2: Métodos

Define **qué métodos de pago aparecen** en el checkout y en qué orden. El panel lo resume así: "Selecciona y ordena los métodos de pago que quieres que aparezcan en tu checkout".

## Quick Payments

Métodos rápidos basados en wallets del navegador o del sistema operativo. Solo se muestran si hay un método de tipo Tarjeta configurado en el checkout:

- **Apple Pay** (toggle on/off)
- **Google Pay** (toggle on/off)

## Métodos de pago

Lista de los métodos disponibles. Cada fila lidera con el método, no con quién lo procesa. Para cada uno se muestra:

- **Asas de drag** para reordenar mediante arrastre.
- **Logotipo y nombre del método** en negrita (Tarjeta, Bizum, Pepper, Financiar...).
- Debajo, en pequeño, el **origen** del método: **`Proveedor - Cuenta`** si va contra una conexión directa (por ejemplo `Adyen - Adyen` o `Redsys - Bizum`), o **`Orquestación - Nombre`** si va contra una orquestación (por ejemplo `Orquestación - Bizum`).
- **Toggle** para activar o desactivar el método.
- **Icono `|||`** que abre la Configuración por método.

Puedes añadir métodos con los botones **"Añadir tarjeta"** y **"Añadir método"**.

> 🧐 Además de las orquestaciones de tarjeta, aquí puedes usar orquestaciones de **Financiación** y de **Método alternativo**. En el listado se identifican por su método, así que una fila te dice qué ofrece el checkout, no quién lo liquida.

# Configuración por método (icono `|||`)

Al hacer clic en el icono **`|||`** se abre el modal **"Configuración de método de pago"** con dos pestañas y un área de **Previsualización** en la parte superior, que refleja los cambios al momento.

Abajo del modal tienes **Eliminar**, para quitar el método del checkout, y **Cancelar** y **Guardar**. Dentro de la pestaña Apariencia hay además un enlace **Restablecer valores predeterminados**.

## Pestaña Apariencia

Personaliza cómo se ve el método en el checkout. Las opciones varían según el método:

- **Tarjeta**: Texto en selector e Icono en selector (tamaño recomendado 70x70px). No tiene modo botón porque siempre se renderiza con su formulario embebido.
- **El resto de métodos**, incluidos los de **financiación** y los de **método alternativo**: lo mismo que Tarjeta, más el toggle **Selector / Botón**, **Color de fondo del botón** y **Logo en botón**.

## Pestaña Condicionantes

Define a quién se le muestra este método individualmente dentro del checkout. Esto crea un **modelo de doble nivel de segmentación**:

- A nivel **checkout** (pestaña Segmentación): decides a quién mostrar el checkout completo.
- A nivel **método** (esta pestaña): decides qué métodos aparecen dentro del checkout para cada cliente.

Toggle de lógica:

- **Mostrar si** → el método aparece solo si la condición se cumple.
- **No mostrar si** → el método se oculta si la condición se cumple.

Las variables disponibles son las mismas que en Segmentación: Operación (9) + Cliente (9).

Casos de uso típicos:

- Mostrar Bizum solo si `País IP = ES`.
- Mostrar Pepper solo si `Precio > 60 EUR`.

# Pestaña 3: Apariencia

Gestión de **Temas reutilizables** entre checkouts.

- Botón **"Nuevo tema"** para crear uno desde cero.
- Galería de temas existentes con preview visual.
- Cada tema tiene un radio button para activarlo en este checkout y un menú **"..."** para editarlo.

> 🧐 Los temas son globales: si modificas un tema, el cambio se aplica automáticamente en todos los checkouts que lo usan. Puedes aprender más sobre la gestión de temas en [esta guía](https://academy.zrupay.com/es/article/gestionar-temas-de-checkout-svz143/).

# Pestaña 4: Configuración avanzada

Ajustes técnicos del checkout:

- **Activar checkout**: permite desactivarlo. El checkout predeterminado no se puede desactivar.
- **Forzar opción MOTO**: fuerza la opción MOTO en todas las operaciones de este checkout.
- **Ignorar error de SCA requerido**: ignora el error de autenticación reforzada si el banco lo requiere.
- **Forzar en caso de error 3DS**: fuerza el intento de pago aunque falle la autenticación 3DS por versión obsoleta.
- **Orquestación para cobros recurrentes**: permite usar una orquestación distinta para los cobros recurrentes generados a partir de pagos en este checkout. Por defecto: "Sin orquestación".

# Preview en vivo

El panel derecho muestra un preview funcional del checkout en tiempo real. Puedes controlarlo con tres ejes:

- **Tipo de operación**: Pago único, Suscripción o Autorización.
- **Viewport**: Desktop 🖥️ o Mobile 📱.
- **Modo**: Redirección (vista completa con resumen del pedido) o iFrame (solo el formulario, sin resumen, para cuando lo incrustas en tu propia página).

También tienes un **selector de zoom** en la esquina superior derecha.

# Publicar cambios

Una vez configurado el checkout, haz clic en **Publicar** arriba a la derecha. Mientras no publiques, los cambios no se aplican al checkout en producción.

# Casos de uso prácticos

## Checkouts por moneda

- **Checkout EUR** → Segmentación: Moneda Igual a EUR → métodos españoles (Bizum, Tarjeta vía Redsys).
- **Checkout USD** → Segmentación: Moneda Igual a USD → métodos internacionales (Tarjeta vía Stripe, PayPal).

## Checkout con tema unificado

- En la pestaña Apariencia, crea un tema con tu marca.
- Aplica el mismo tema en todos los checkouts del comercio.
- Si actualizas el tema, todos los checkouts heredan los cambios automáticamente.