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.El dashboard de Reval te acompaña: mientras falte configuración vas a ver la tarjeta «Primeros pasos» con el estado real de cada punto (credenciales guardadas, webhook verificado, primer plan creado) y un acceso directo a esta guía. Desaparece sola cuando todo está listo.
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.
1
Instalá la app con tu link de instalación
Reval es una app de distribución custom: no está publicada en el Shopify App Store. Vas a recibir un link de instalación generado específicamente para tu tienda.Abrilo con la sesión de propietario de la tienda y aceptá los permisos. Una vez instalada, Reval aparece en Apps dentro de tu admin, embebida — no hay ningún sitio externo al que entrar.
El link está anclado al dominio de tu tienda y solo sirve para ella.
2
Cargá tus credenciales de Mercado Pago
Reval necesita acceso a tu cuenta de Mercado Pago para crear los mandatos de cobro recurrente y recibir la notificación de cada cobro.No hay conexión por OAuth: las credenciales se copian del panel de MP y se pegan en Reval, donde quedan guardadas de forma cifrada para tu tienda.
Todo lo que sigue se hace en el panel de desarrolladores de Mercado Pago, dentro de tu aplicación. Si todavía no la creaste, el paso 2.0 te guía; si ya la tenés, saltá directo al 2.1.
Creá una aplicación nueva y dedicada a Reval. No reutilices la que uses para cobrar en tu checkout.Por dos motivos:
Cada aplicación se crea para un producto de Mercado Pago. Una aplicación de checkout no habilita las APIs de Suscripciones, que son las que Reval necesita para los cobros recurrentes.
Cada aplicación admite una sola URL de webhook por modo. Si pegás la URL de Reval en una aplicación que ya tiene un webhook configurado, lo pisás — y las notificaciones de tu checkout dejan de llegar a donde iban, sin ningún aviso.
Tener dos aplicaciones no separa tu dinero ni tus cuentas: ambas pertenecen a la misma cuenta de Mercado Pago y todo se acredita en el mismo lugar. Una aplicación es una credencial de integración, no una billetera. No tiene costo ni límite.
Si vendés con Mercado Pago pero nunca entraste al panel de desarrolladores, probablemente no tengas ninguna aplicación propia: la integración de pagos de Shopify se vincula desde el admin de la tienda, sin pasar por ahí. En ese caso simplemente creá la primera.
Acceso a Integraciones en el panel de desarrolladores
En Gestión de integraciones, tocá + Crear aplicación.
Gestión de integraciones — Crear aplicación
Elegí Crear en el panel de integración (no «Crear con IA»): es la opción que crea la aplicación y te da acceso a las credenciales.
Crear en el panel de integración
En Elegí una solución para integrar, seleccioná Suscripciones («Automatiza cobros recurrentes en tu sitio»).
Elegí la solución Suscripciones
Este es el cambio respecto del flujo anterior de Mercado Pago: antes había que elegir Pagos online → Con un desarrollo propio → Checkout API. Ahora Suscripciones es una solución dedicada y es la correcta para Reval — es la que habilita las APIs de cobro recurrente.
Abrí Otros datos, completá el Nombre de la aplicación (por ejemplo, «Reval - Suscripciones»), tildá la autorización de datos personales y tocá Crear aplicación.
Otros datos — nombre y autorización
Con la aplicación creada, entrá a ella desde Gestión de integraciones y seguí con el paso 2.1.
En el menú lateral, entrá a NOTIFICACIONES → Webhooks. Verificá que estés en la pestaña Modo productivo y no en «Modo de prueba»: son dos configuraciones independientes y la de prueba no se usa.
Configuración de webhooks en modo productivo
En URL de producción, pegá la URL de notificaciones (webhook) que Reval te muestra en Configuración → Integraciones — Mercado Pago (tiene un botón Copiar URL al lado). La URL ya viene armada con tu tienda — no hace falta editarla.
El ?shop= del final no es opcional: es lo que le indica a Reval de qué tienda viene la notificación y con qué clave secreta validarla. Si lo omitís, Mercado Pago igual responde 200 y todo parece funcionar, pero estás dependiendo de un mecanismo de respaldo. Copiá la URL completa, tal como Reval la muestra.
En Eventos recomendados para integraciones con Suscripciones, tildá exactamente dos:
Planes y suscripciones
Pagos (legacy)
No tildes ningún otro. Los eventos de más no rompen nada, pero generan tráfico que Reval descarta.
Copiá la Clave secreta que aparece abajo de todo. Ese es el tercer valor que vas a pegar en Reval.
Tocá Guardar configuración.
El botón de refrescar que está al lado de la clave secreta genera una nueva e invalida la anterior. Si lo tocás después de haber configurado Reval, los webhooks empiezan a fallar la validación de firma y los cobros dejan de generar pedidos en Shopify. Si te pasa, copiá la clave nueva y actualizala en Reval.
El nombre «Pagos (legacy)» suena a algo discontinuado, pero es el evento correcto: es el que notifica cada cobro individual del mandato, y es el que Reval escucha para crear el pedido en Shopify.
En Reval, andá a Configuración → Integraciones — Mercado Pago y completá:
Public key (empieza con APP_USR)
Access token (empieza con APP_USR)
Webhook secret — la clave secreta del paso anterior
Guardá.
El access token y el webhook secret no se vuelven a mostrar una vez guardados: los campos quedan enmascarados. Es el comportamiento esperado. Si necesitás cambiarlos, escribís el valor nuevo encima y guardás de nuevo.
Tocá Probar conexión. La prueba usa las credenciales guardadas, así que guardá antes de probar.Si todo está bien, aparece un mensaje verde con el nombre de tu cuenta de Mercado Pago y el código de tu país (MLA Argentina, MLB Brasil, MLC Chile, MCO Colombia, MLM México, MPE Perú, MLU Uruguay).
Qué ves
Qué significa
«Conexión OK — tu cuenta (MLA)»
Listo, seguí al paso siguiente.
«Mercado Pago rechazó el access token»
El token está incompleto o es de prueba. Copialo de nuevo desde Credenciales de producción.
Conexión OK pero con otro nombre de cuenta
Frená acá. Ver la advertencia de abajo.
Si el nombre que aparece no es el de tu cuenta, el access token es de otra cuenta: frená ahí. Un token equivocado no da error, simplemente cobraría a la cuenta incorrecta.Tené en cuenta además que Reval opera con credenciales productivas: no hay modo sandbox, y las tarjetas de prueba de MP no funcionan. Para validar el flujo se hace una compra real de monto chico y después se reembolsa.
El paso anterior prueba las credenciales; este confirma que las notificaciones de Mercado Pago llegan a Reval y validan bien. Es lo que el dashboard de Reval marca como «Webhook de Mercado Pago» en la tarjeta «Primeros pasos»: queda pendiente hasta que Reval reciba una notificación válida.
En el panel de MP, volvé a NOTIFICACIONES → Webhooks → Modo productivo (donde configuraste la URL en el paso 2.2).
Tocá Simular notificación y enviá una de prueba (por ejemplo, del evento Pagos). MP la manda a tu URL, con el ?shop= y firmada con la clave secreta.
Volvé al dashboard de Reval: en Primeros pasos, el ítem «Webhook de Mercado Pago» pasa a «último recibido: …» con la fecha. Con eso queda validado.
Guardá primero los tres valores en Reval (paso 2.3): la validación de la notificación usa la clave secreta guardada. Si simulás antes de guardarla, la firma no valida y el paso no se tilda.
3
Creá tu primer plan de suscripción
Los planes definen la frecuencia de cobro y el descuento que reciben los suscriptores respecto al precio de lista.
Dirigite a Planes en el menú lateral de Reval y completá la sección Crear un plan de suscripción.
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.
Tipo de descuento: porcentaje de descuento (entre 1 y 99, sobre el precio de lista de cada producto) o precio fijo (el mismo monto para todos los productos del plan). Si no querés aplicar descuento, usá precio fijo con el precio normal del producto.
Descuento extra 1er pedido (opcional): un porcentaje adicional que aplica SOLO al primer cobro. Desde el segundo ciclo se cobra el precio normal del plan, y el comprador ve ambos precios antes de suscribirse.
Seleccioná los productos y hacé clic en Crear plan.
Mercado Pago tiene un monto mínimo por cobro (depende de la moneda de tu cuenta). Reval no permite guardar planes cuyo precio final quede por debajo de ese mínimo y te muestra el valor exacto al intentarlo — si ves ese aviso, subí el precio o bajá el descuento.
Podés crear tantos planes como necesités. Los compradores los verán como opciones en el buy box del producto.
4
Agregá el bloque de Reval a tu theme
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. Se agrega como un bloque de app desde el editor de temas — sin tocar código:
En Shopify: Tienda online → Temas → Personalizar.
Abrí una página de producto y, en la sección de información del producto, hacé clic en Agregar bloque → Apps → «Reval».
Guardá. El bloque se acomoda solo junto a los botones de compra (cantidad → opciones → botón de suscribirse), lo dejes donde lo dejes.
Desde la configuración del bloque podés editar los beneficios que se muestran al elegir la suscripción y activar la preselección de la opción de suscribirse. El ajuste «Mostrar opción de compra única» (activado por defecto) controla si el buy box ofrece la compra sin suscripción: desactivalo para vender el producto solo por suscripción. El logo, el color de acento y el favicon del checkout se definen de forma centralizada en el módulo Marca de Reval.
Ícono de la pestaña del navegador: se define en el módulo Marca de Reval (campo Favicon). Si lo dejás vacío, usa el logo del checkout, y como último recurso el logo cuadrado de tu tienda en Shopify (Configuración → Marca → Logo cuadrado, distinto del favicon del theme); si tampoco está, Reval adapta tu logo principal a un cuadrado.
El buy box solo aparece en productos que tienen un plan activo — en el resto el bloque es invisible, así que es seguro agregarlo al template general de producto.
Preview del buy box con la opción de suscripción activa
¿Querés vender suscripciones desde una landing? Reval trae un segundo bloque, «Reval · Sección de suscripción», para cualquier página que no sea de producto — una landing, la home, una página «Suscribite». El comprador elige el producto, la variante, la cantidad y la frecuencia, y se suscribe desde ahí:
En el editor de temas abrí la página (por ejemplo Páginas → tu landing) y agregá una sección Apps (o cualquier sección que acepte bloques de apps).
Agregar bloque → Apps → «Reval · Sección de suscripción».
En la configuración del bloque elegí los productos (hasta 12). Con dos o más, el comprador ve una tarjeta por producto; si el producto tiene variantes, aparecen como botones para elegir.
Opcional: nombres cortos para las tarjetas (uno por línea, en el orden de la lista — «Naranja» en vez de «Electrolitos Naranja x30»), título, texto introductorio, beneficios y texto del botón.
Este bloque es solo suscripción (no ofrece compra única) y no aparece en las páginas de producto — ahí va el bloque «Reval». Si un producto de la lista no tiene un plan activo, el botón queda deshabilitado con un aviso: asignale un plan en Planes o quitalo de la lista. Si elegís una caja de Reval, el botón lleva al armado de la caja.
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.
5
Agregá el acceso al portal en la cuenta del cliente
Reval incluye un bloque para las cuentas de cliente de Shopify que le da a cada suscriptor un acceso directo al portal desde su cuenta — donde puede pausar, cambiar productos, actualizar su dirección, revisar pedidos y cancelar. El bloque viene con la app; vos solo tenés que agregarlo en el editor de cuentas de cliente.
Funciona con las nuevas cuentas de cliente de Shopify (Customer Accounts), no con las cuentas clásicas.
En Shopify: Configuración → Cuentas de cliente y abrí el editor de personalización de las páginas de cuenta (botón Personalizar).
Entrá a la página Perfil y hacé clic en Agregar bloque → Apps → «Mi Suscripción» (el bloque de suscripción de Reval).
Guardá.
Con eso, el cliente ve «Mi Suscripción» en la navegación de su cuenta. Al abrirla encuentra un enlace «Ver y gestionar mis suscripciones» que lo lleva al portal, ya autenticado por su sesión — no necesita ingresar ningún dato extra.
Si «Mi Suscripción» no aparece en la lista de bloques de apps, es porque la extensión todavía no fue desplegada a tu tienda. Avisale a tu contacto de Reval para que la publique — se distribuye junto con la app, no se instala aparte.
6
Hacé una suscripción de prueba
Antes de anunciar la funcionalidad a tus clientes, verificá que el flujo completo funcione de extremo a extremo.Como Reval opera con credenciales productivas, la prueba se hace con una tarjeta real y un monto chico, que después reembolsás. Conviene crear un plan temporal barato para esto.
Abrí la página del producto donde aparece el buy box en una ventana de incógnito.
Elegí el plan de prueba y completá el checkout con una tarjeta real.
Verificá que:
El pedido aparezca en Pedidos dentro del admin de Shopify, con las etiquetas Suscripción, Primera compra y Ciclo 1.
La suscripción aparezca en Suscripciones dentro de Reval, en estado activo.
El mandato figure en tu panel de Mercado Pago.
Cancelá la suscripción de prueba y reembolsá el cobro desde el panel de MP.
Si además ofrecés add-ons, tildá uno en el checkout de prueba: verificá que en Mercado Pago aparezcan dos cargos separados (el del mandato y el del add-on) y que el pedido incluya ambas líneas.
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.
Saltar un ciclo existe, pero con fecha aproximada: se activa desde Configuración → Pedidos e inventario, y por debajo funciona pausando el débito y reactivándolo un ciclo después, así que la fecha del cobro siguiente la decide Mercado Pago al reactivar. El detalle está en Limitaciones.
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.
