> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appreval.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuración completa de Reval en tu tienda Shopify

> Personalizá Mercado Pago, el checkout, los límites de suscripciones y la página de agradecimiento desde el panel de configuración de Reval.

El panel de configuración de Reval te permite adaptar cada aspecto de la experiencia de suscripción a las necesidades de tu tienda. Accedé desde **Reval → Configuración** en tu admin de Shopify. Los cambios se aplican de forma inmediata sin necesidad de reiniciar ni volver a instalar nada.

<Tip>
  Antes de activar cobros reales, conectá una cuenta de **sandbox** de Mercado Pago y completá al menos una suscripción de prueba. Así podés verificar el flujo completo sin procesar dinero real. Cuando estés listo, cambiá el ambiente a **Producción** con un solo clic.
</Tip>

***

## Mercado Pago

Esta sección gestiona la conexión entre Reval y tu cuenta de Mercado Pago. Sin una conexión activa, el checkout de suscripciones no estará disponible para tus compradores.

<Accordion title="Conectar o reconectar cuenta">
  Reval usa OAuth para conectarse con Mercado Pago: en ningún momento almacena tu usuario ni contraseña.

  **Para conectar por primera vez:**

  1. Hacé clic en **Conectar cuenta de Mercado Pago**.
  2. Se abre una ventana de autorización de Mercado Pago.
  3. Iniciá sesión con tu cuenta de vendedor y aceptá los permisos (creación de mandatos de pago recurrente y recepción de webhooks).
  4. Una vez autorizado, el estado cambia a **Conectada** y se muestra el nombre de la cuenta vinculada.

  **Para reconectar** (por ejemplo, si cambiaste de cuenta o el token venció):

  1. Hacé clic en **Desconectar cuenta**.
  2. Confirmá la acción — las suscripciones activas quedan pausadas automáticamente hasta que reconectes.
  3. Seguí los mismos pasos de conexión inicial con la nueva cuenta.

  <Warning>
    Si desconectás la cuenta de Mercado Pago, todos los cobros recurrentes programados se suspenden hasta que completes la reconexión. Notificá a tus suscriptores si el corte se extiende más de un ciclo de facturación.
  </Warning>
</Accordion>

<Accordion title="Ambiente: Producción vs. Sandbox">
  Reval permite alternar entre dos ambientes de Mercado Pago sin necesidad de crear una nueva conexión.

  | Ambiente       | Descripción                                                                                                  |
  | -------------- | ------------------------------------------------------------------------------------------------------------ |
  | **Sandbox**    | Procesa pagos simulados con tarjetas de prueba de Mercado Pago. Ideal para testear el flujo antes de lanzar. |
  | **Producción** | Procesa cobros reales con las tarjetas de tus suscriptores.                                                  |

  Para cambiar el ambiente, seleccioná la opción correspondiente en el selector **Ambiente activo** y guardá. El cambio aplica inmediatamente a todos los nuevos checkouts.

  <Note>
    Cambiar el ambiente no afecta las suscripciones ya activas; solo determina cómo se procesan las nuevas tokenizaciones de tarjeta y los cobros futuros en suscripciones creadas a partir de ese momento.
  </Note>
</Accordion>

***

## Checkout

Reval utiliza un checkout personalizado embebido en tu tienda. El comprador nunca abandona tu dominio, y los datos de la tarjeta se tokenizan directamente en el navegador antes de llegar al servidor.

<Accordion title="Campos del formulario">
  El formulario de checkout de Reval replica la configuración de tu tienda Shopify. Dado que algunas opciones del checkout de Shopify no son accesibles vía API, los campos visibles en Reval se configuran directamente desde **Configuración → Checkout** dentro de Reval para mantenerlos alineados con tu tienda.

  Los campos disponibles son:

  | Campo                            | Cuándo se muestra                                                        |
  | -------------------------------- | ------------------------------------------------------------------------ |
  | **Nombre y apellido**            | Siempre requerido                                                        |
  | **Teléfono**                     | Según lo que hayas configurado en esta sección                           |
  | **DNI / documento de identidad** | Según lo que hayas configurado en esta sección                           |
  | **Dirección de envío**           | Siempre requerida (usada para calcular envío e impuestos en tiempo real) |

  Los envíos e impuestos aplicables se consultan en vivo a Shopify en cada checkout, usando las mismas reglas que configuraste para tu tienda.

  <Note>
    Si modificás los campos del checkout de Shopify (por ejemplo, hacés obligatorio el teléfono), acordate de aplicar el mismo cambio en esta sección de Reval para que ambas experiencias queden alineadas.
  </Note>
</Accordion>

<Accordion title="URL de éxito (página de agradecimiento)">
  Define a qué página redirige Reval luego de que un suscriptor completa el checkout exitosamente.

  * Por defecto, Reval redirige a la **página de agradecimiento propia** (configurable en la sección [Página de agradecimiento](#página-de-agradecimiento) más abajo).
  * Podés reemplazarla con cualquier URL de tu tienda, por ejemplo `/pages/bienvenida-suscriptores`.

  Los links de redirección están **firmados criptográficamente**, lo que impide que se manipulen los parámetros de confirmación en tránsito.
</Accordion>

<Accordion title="Límite de intentos fallidos">
  Configurá cuántos intentos fallidos de cobro tolera Reval antes de bloquear automáticamente el método de pago del suscriptor.

  * **Valor por defecto**: 3 intentos.
  * **Rango permitido**: 1 a 10 intentos.
  * Cuando se supera el límite, la suscripción pasa al estado **Pago fallido** y el suscriptor recibe una notificación para actualizar su tarjeta.

  <Tip>
    Un límite de 3 intentos es el estándar recomendado. Valores más bajos reducen la exposición a tarjetas inválidas; valores más altos dan más margen para errores transitorios del banco.
  </Tip>
</Accordion>

***

## Suscripciones

Controlá el comportamiento global de las suscripciones en tu tienda: cuántas puede tener cada cliente y qué pasa cuando un producto se queda sin stock.

<Accordion title="Máximo de suscripciones activas por cliente">
  Limitá cuántas suscripciones simultáneas puede tener un mismo comprador (identificado por su email).

  * **0** = sin límite (los clientes pueden suscribirse a tantos productos como quieran).
  * **Cualquier número mayor a 0** = límite máximo de suscripciones activas por cliente.

  Si un comprador intenta crear una nueva suscripción superando el límite configurado, el checkout muestra un mensaje de error explicativo y no le permite continuar.

  <Note>
    Este límite aplica a suscripciones **activas**. Las suscripciones canceladas o pausadas no cuentan para el cálculo.
  </Note>
</Accordion>

<Accordion title="Comportamiento ante falta de stock">
  Definí qué hace Reval cuando llega el momento de renovar una suscripción pero el producto no tiene stock disponible.

  | Opción                     | Comportamiento                                                                                                                          |
  | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
  | **Pausar automáticamente** | La suscripción pasa al estado **Pausada** y no se intenta el cobro. Se reanuda automáticamente cuando el producto vuelva a tener stock. |
  | **Continuar**              | Reval intenta el cobro igual. El pedido resultante puede quedar en estado de espera según las reglas de tu tienda.                      |

  **Recomendación**: usá **Pausar automáticamente** si vendés productos físicos con stock limitado. Usá **Continuar** si vendés productos digitales o servicios sin restricción de inventario.
</Accordion>

***

## Página de agradecimiento

La página de agradecimiento es lo primero que ve tu nuevo suscriptor al completar el checkout. Personalizala para reforzar la identidad de tu marca.

<Accordion title="Logo personalizado">
  Ingresá la URL pública de tu logo (formato recomendado: PNG o SVG, fondo transparente, ancho mínimo 300 px).

  Ejemplo: `https://tu-tienda.com/assets/logo.png`

  Si no configurás un logo, Reval muestra el nombre de tu tienda en texto plano.
</Accordion>

<Accordion title="Mensaje de bienvenida">
  Redactá el texto principal que aparece debajo del logo. Podés usar hasta **280 caracteres**.

  Ejemplo: *«¡Gracias por suscribirte! A partir de ahora recibís tu caja cada mes en la puerta de tu casa.»*

  <Tip>
    Usá este espacio para confirmar qué va a recibir el suscriptor, cuándo llega el primer pedido y cómo contactar al soporte. Un mensaje claro reduce los tickets de «¿cuándo llega mi pedido?».
  </Tip>
</Accordion>

<Accordion title="Color de acento">
  Elegí el color principal que Reval usa en los botones y elementos destacados de la página de agradecimiento. Ingresá el valor en formato hexadecimal.

  Ejemplo: `#E63946`

  El color de acento también se aplica al botón de llamada a la acción («Ver mi suscripción») y a los íconos de confirmación. Elegí un color con suficiente contraste sobre fondo blanco para garantizar legibilidad (relación de contraste mínima recomendada: 4.5:1).
</Accordion>
