- Lectura: pedidos, productos, impuestos, tarifas de envío y datos de clientes.
- Escritura: creación y actualización de pedidos recurrentes.
Instalá la app con tu link de instalación
Cargá tus credenciales de Mercado Pago
2.0 — Creá la aplicación (solo la primera vez)
Entrá al panel de desarrolladores de Mercado Pago con la cuenta de MP que va a cobrar las suscripciones y, arriba a la derecha, tocá Integraciones.
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
-
Entrá a la aplicación recién creada desde Gestión de integraciones y, en el menú lateral, bajá hasta PRODUCCIÓN → Credenciales de producción. La primera vez, Mercado Pago te pide activar las credenciales antes de mostrarlas: elegí la Industria que mejor describe tu negocio, ingresá el Sitio web de tu tienda (con
https://), tildá la autorización de datos personales, resolvé el «No soy un robot» y tocá Activar credenciales de producción.
Activar las credenciales de producción
Hasta que no completes este paso, la pantalla no muestra la Public Key ni el Access Token.
2.1 — Copiá las credenciales de producción
En el menú lateral, bajá hasta PRODUCCIÓN → Credenciales de producción.
Credenciales de producción en el panel de Mercado Pago
2.2 — Configurá el webhook
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.
-
En Eventos recomendados para integraciones con Suscripciones, tildá exactamente dos:
- Planes y suscripciones
- Pagos (legacy)
- Copiá la Clave secreta que aparece abajo de todo. Ese es el tercer valor que vas a pegar en Reval.
- Tocá Guardar configuración.
2.3 — Pegá los tres valores en Reval
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
2.4 — Probá la conexión
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).2.5 — Validá las notificaciones (webhook)
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.
Creá tu primer plan de suscripción
- 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 que aplica SOLO al primer cobro, calculado sobre el precio de lista. Reemplaza al descuento del plan en ese primer pedido, no se suma. Desde el segundo ciclo se cobra el precio normal del plan, y el comprador ve ambos precios antes de suscribirse. Más detalle en Planes.
- Seleccioná los productos y hacé clic en Crear plan.
Agregá el bloque de Reval a tu theme
- 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.

Preview del buy box con la opción de suscripción activa
- 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 de la lista de productos, título, texto introductorio, beneficios y texto del botón.
- Opcional, para la imagen del producto:
- Mostrar la imagen del producto: prende o apaga la imagen junto a las tarjetas.
- Fijar la imagen al hacer scroll: en pantallas anchas, la imagen y las tarjetas acompañan el scroll mientras se lee la columna de la derecha. En celulares no tiene efecto.
- Ajuste de la imagen: Recortar para llenar el cuadro (puede cortar los bordes) o Mostrar completa (sin recortar), con espacio alrededor si hace falta.
- En el editor de temas abrí Incrustaciones de aplicaciones (App embeds) en la barra lateral.
- Activá «Reval · Carrito de suscripciones» y guardá.
- Antes de agregar un producto, Reval verifica que se pueda suscribir (plan activo para esa frecuencia, stock y el máximo de suscripciones nuevas por día). Si no se puede, muestra el mismo aviso que el checkout.
- Cada frecuencia es una suscripción. Mercado Pago cobra cada suscripción con una sola frecuencia, así que un carrito con productos mensuales y bimestrales crea dos suscripciones. El comprador paga una sola vez al suscribirse, pero desde ahí ve un débito por frecuencia. El carrito lo avisa antes de pagar.
- El carrito de suscripciones está separado del carrito de la tienda: las compras únicas se siguen pagando en el checkout de Shopify. El carrito lo explica arriba de los productos y aclara al pie que los cupones de la tienda aplican solo a compras únicas.
- Los productos quedan guardados en el navegador del comprador hasta que paga o los quita.
- Botón flotante: aparece en todas las páginas cuando hay productos en el carrito, abajo a la derecha o a la izquierda.
- Tipografía: por defecto el carrito usa la del theme. Podés elegir una fuente propia y el tamaño de letra para todo el carrito.
- Estilo: color de los botones y de su texto, fondo del carrito, color del texto y redondeo de los botones. Vacío o en 0 = el valor del theme. Completalos solo si querés forzar otro.
- Botones por separado: «Agregar al carrito» (el que reemplaza al «Suscribirme» del bloque mientras el carrito está activo), «Continuar al pago» y el botón flotante tienen cada uno su color, color de texto, redondeo y tamaño de letra, que pisan los del grupo Estilo. Si también pintaste el botón desde el bloque «Reval» de la página de producto, gana el ajuste del bloque.
- Textos: el título del carrito, el aviso de carritos separados y la aclaración sobre cupones. Vacío = texto por defecto.
- Aviso en el carrito de la tienda: agrega en el carrito del theme un mensaje que explica que las suscripciones se pagan aparte, con el link «Ver mis suscripciones». Depende del theme: si no aparece o queda en un lugar raro, desactivalo.
Agregá el acceso al portal en la cuenta del cliente
- 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á.
Hacé una suscripción de prueba
- 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 comprayCiclo 1. - La suscripción aparezca en Suscripciones dentro de Reval, en estado activo.
- El mandato figure en tu panel de Mercado Pago.
- El pedido aparezca en Pedidos dentro del admin de Shopify, con las etiquetas
- Cancelá la suscripción de prueba y reembolsá el cobro desde el panel de MP.
Cargá la tarjeta de facturación