> ## 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.
# Primeros pasos con Reval: instalá y configurá tu tienda
> Instalá Reval en tu tienda Shopify, conectá Mercado Pago y creá tu primer plan de suscripción recurrente en menos de 15 minutos.
Reval se instala directamente en tu admin de Shopify y no requiere modificar código ni contratar infraestructura adicional. Seguí esta guía paso a paso para tener tu tienda lista para vender suscripciones recurrentes cobradas por Mercado Pago.
Reval solicita los siguientes permisos en tu tienda Shopify al momento de la instalación:
* **Lectura**: pedidos, productos, impuestos, tarifas de envío y datos de clientes.
* **Escritura**: creación y actualización de pedidos recurrentes.
Estos permisos son estrictamente necesarios para generar los cobros automáticos y calcular envíos e impuestos en tiempo real durante el checkout.
Accedé al panel de administración de tu tienda en `tu-tienda.myshopify.com/admin`. Desde ahí, dirigite a **Apps** en el menú lateral y buscá **Reval** en el Shopify App Store. Hacé clic en **Instalar** y aceptá los permisos solicitados.
Una vez completada la instalación, vas a ver la interfaz de Reval embebida directamente en tu admin, sin necesidad de acceder a ningún sitio externo.
Reval necesita acceso a tu cuenta de Mercado Pago para crear mandatos de pago recurrente y recibir notificaciones de cobros (webhooks). El proceso usa OAuth, por lo que tus credenciales nunca son almacenadas por Reval.
1. Dentro de Reval, dirigite a **Configuración → Mercado Pago**.
2. Hacé clic en **Conectar cuenta**.
3. Se abre una ventana de Mercado Pago: iniciá sesión con tu cuenta de vendedor y autorizá los permisos solicitados.
4. Una vez autorizado, volvés automáticamente a Reval y el estado de la conexión aparece como **Activa**.
Antes de activar en producción, te recomendamos conectar primero una cuenta de **sandbox** de Mercado Pago para realizar pruebas sin dinero real. Podés cambiar el ambiente en cualquier momento desde la misma sección de configuración.
Los planes definen la frecuencia de cobro y el descuento que reciben los suscriptores respecto al precio de lista.
1. Dirigite a **Planes** en el menú lateral de Reval.
2. Hacé clic en **Nuevo plan**.
3. Completá los campos:
* **Nombre del plan**: por ejemplo, «Mensual» o «Trimestral con descuento».
* **Frecuencia**: combiná un intervalo numérico con una unidad de tiempo — **días**, **semanas** o **meses**. Por ejemplo: 1 mes para cobro mensual, 3 meses para trimestral, 14 días para quincenal.
* **Descuento**: ingresá el porcentaje de descuento sobre el precio original del producto (podés dejarlo en 0 si no querés aplicar descuento).
4. Guardá el plan.
Podés crear tantos planes como necesités. Los compradores los verán como opciones en el buy box del producto.
El buy box es el widget que aparece en la página de producto y permite al comprador elegir entre comprar una sola vez o suscribirse.
1. Dirigite a **Productos** dentro de Reval, o bien abrí el producto directamente desde el admin de Shopify.
2. Buscá la sección de **Reval** en el panel del producto.
3. Activá el interruptor **Habilitar suscripción**.
4. Asigná uno o varios planes al producto.
5. Guardá los cambios.
Además, en el **customizer del theme** de Shopify (Online Store → Themes → Customize), abrí la página de producto y seleccioná el bloque **Buy button**. Ahí vas a encontrar la opción **Habilitar suscripciones (Mercado Pago)** para mostrar los planes en el buy box, junto con textos y beneficios editables desde el editor de temas.
Una vez activado, el buy box muestra las opciones de **Compra única** y **Suscribirme y ahorrar** con el descuento del plan aplicado.
El buy box requiere que el theme de tu tienda tenga **JavaScript habilitado**. Si usás un theme altamente personalizado o con scripts bloqueados, verificá que el widget cargue correctamente antes de publicarlo.
Antes de anunciar la funcionalidad a tus clientes, verificá que el flujo completo funcione de extremo a extremo.
1. Asegurate de tener el ambiente de Mercado Pago configurado en **sandbox**.
2. Abrí la página del producto donde activaste el buy box en una ventana de incógnito.
3. Elegí un plan de suscripción y completá el checkout con los datos de una tarjeta de prueba de Mercado Pago.
4. Verificá que:
* El pedido aparezca en **Pedidos** dentro del admin de Shopify.
* La suscripción aparezca en **Suscripciones** dentro de Reval.
* Recibas la notificación de pago en el dashboard de tu cuenta sandbox de Mercado Pago.
Una vez validado el flujo, cambiá el ambiente a **producción** en **Configuración → Mercado Pago** y ya podés recibir suscriptores reales.
***
## Limitaciones conocidas
Antes de lanzar tu programa de suscripciones, tené en cuenta las siguientes restricciones actuales de Reval:
* **No hay cobro bajo demanda**: no podés iniciar un cobro manual fuera del ciclo programado. Los cobros los ejecuta automáticamente Mercado Pago en la fecha programada.
* **No se puede saltar un ciclo**: no existe una opción para omitir un período de cobro sin pausar la suscripción completa.
* **No se puede cambiar la fecha del próximo cobro**: la fecha del siguiente ciclo la determina Mercado Pago según la frecuencia del plan y no puede adelantarse ni postergarse manualmente.
* **No se puede cambiar la frecuencia de una suscripción activa**: si un suscriptor quiere pasar de un plan mensual a uno trimestral, la única vía es cancelar la suscripción actual y crear una nueva con el plan deseado.
* **No hay tarjetas de respaldo**: cada suscripción está asociada a un único método de pago. Si el cobro falla, no se intenta con otro medio.
***
## Próximos pasos
Ahora que tu tienda está configurada para recibir suscripciones, explorá las siguientes secciones para personalizar y optimizar tu operación:
Creá, editá y archivá planes de suscripción. Aprendé a configurar frecuencias, descuentos y asignarlos a múltiples productos.
Ajustá los límites de suscripciones por cliente, el comportamiento ante falta de stock, la página de agradecimiento y más.