Shopify es la única fuente de verdad. Cada cobro aprobado genera un pedido real en Shopify con sus líneas de producto, costo de envío e impuestos calculados en vivo. No hay base de datos paralela ni pedidos “fantasma”: lo que ves en tu panel de Shopify es lo que realmente se cobró y despachará.
Flujo completo de una suscripción
- Vista del merchant
- Vista del suscriptor
Lo que ocurre en tu tienda
Como merchant, tu interacción principal con Reval sucede en dos momentos: la configuración inicial (planes, descuentos, frecuencias) y la revisión de reportes. El día a día corre automáticamente.Alta de suscripción
1
El comprador elige un plan en el buy box
En la página de producto aparece un selector de planes con frecuencia (semanal, mensual, bimestral, etc.) y el descuento asociado a cada uno. El comprador selecciona el plan y hace clic en “Suscribirse”.
2
Checkout custom de Reval
El comprador ingresa sus datos de tarjeta directamente en el checkout de Reval. La tokenización ocurre en el navegador, sin redirección a Mercado Pago. El servidor de Reval nunca ve el número de tarjeta completo.
3
Creación del mandato de cobro recurrente con monto libre
Reval crea un mandato de cobro recurrente (preapproval) en Mercado Pago usando la modalidad de monto libre, es decir, sin atarlo a un plan fijo de Mercado Pago. Esto es indispensable porque un mandato atado a un plan de MP solo puede cobrar un monto fijo, sin capacidad de sumar envío, impuestos ni descuentos por cliente. Con monto libre, cada ciclo cobra el monto exacto (producto + envío + impuestos) consultado en vivo a las tarifas reales de tu tienda en Shopify.
4
Primer cobro y pedido en Shopify
El primer cobro se ejecuta de inmediato. Cuando Mercado Pago confirma el pago via webhook, Reval crea el primer pedido en Shopify con todas las líneas, el envío y los impuestos. Ese pedido entra a tu flujo de fulfillment normal.
Ciclo recurrente
1
Cobro automático por el mandato
En la fecha del ciclo, Mercado Pago ejecuta el cobro usando el mandato activo. El monto es el que quedó fijado en el mandato —producto, envío e impuesto calculados al momento del alta— y solo cambia si alguien lo actualiza explícitamente desde el admin o el portal.
2
Webhook de MP llega a Reval
Mercado Pago notifica el resultado del cobro (aprobado o rechazado) mediante un webhook. Reval verifica la idempotencia: si el evento ya fue procesado, lo descarta sin crear un pedido duplicado.
3
Pedido creado en Shopify (cobro aprobado)
Si el cobro fue aprobado, Reval crea inmediatamente un pedido en Shopify con las líneas actuales de la suscripción, el costo de envío y los impuestos. El pedido queda disponible para fulfillment al instante.
4
Cobro rechazado
Reval registra el fallo con su motivo y lo muestra en el admin y en el portal. Mercado Pago reintenta el cobro por su cuenta; si los reintentos se agotan, cancela el mandato y Reval marca la suscripción como cancelada. No se crea ningún pedido hasta que haya un cobro aprobado.
Integraciones por webhook (
orders/paid). Cada pedido que crea Reval —primer cobro, renovaciones y compras únicas— se crea primero como pendiente y el cobro de Mercado Pago se registra un instante después como pago. Ese segundo paso es el que dispara el webhook orders/paid de Shopify, así que los ERPs, flujos de Shopify Flow y sincronizaciones contables que escuchan ese evento reciben también los pedidos de suscripción. Los pedidos creados antes de esta mejora nunca lo dispararon: la integración debe importarlos desde la etiqueta Suscripción.Seguridad y confiabilidad
Reval está diseñado para que cada operación sea segura y no genere estados inconsistentes:Tokenización en el navegador
Los datos de tarjeta nunca pasan por los servidores de Reval. El SDK de Mercado Pago tokeniza directamente en el navegador del comprador.
Webhooks idempotentes
Cada evento de Mercado Pago se procesa una sola vez. Si el webhook llega duplicado, Reval lo detecta y no crea un pedido extra.
Links firmados
El portal y el checkout usan links con firma criptográfica. Sin la firma correcta, no hay acceso.
Pedidos que no se pierden
Si un cobro se aprueba pero el pedido no se puede crear —por ejemplo, porque un producto quedó sin stock— queda en cola y un proceso diario lo reintenta hasta lograrlo. El cliente ya pagó: su pedido no se cae.