Ir al contenido

Cobros recurrentes en Odoo con Mercado Pago: el modulo de Epik

Como automatizar el cobro mensual de suscripciones, cuotas y retainers desde Odoo usando la API de Mercado Pago.
Epik desarrolló un módulo para Odoo Enterprise que cobra suscripciones mensuales automáticamente usando la API de Mercado Pago. El cliente firma una autorización una sola vez y Odoo factura, cobra, concilia y gestiona reintentos mes a mes sin intervención manual. Importante: NO es una sincronización con la app "Mercado Pago Suscripciones"; es un manejador de pagos recurrentes nativo dentro de Odoo que usa MP como medio de cobro.

Si tu negocio vive de cobrar cuotas mensuales (un gimnasio, una academia, un SaaS B2B, un servicio con retainer, una caja de productos por suscripción), conoces el problema: cada mes alguien tiene que perseguir pagos, marcar quién pagó y quién no, suspender accesos, reactivar cuentas y conciliar contra el extracto. Ese trabajo manual escala mal y rompe el margen.

En Epik, como partner de Odoo Enterprise, vemos esto repetido en PyMEs de Argentina, México, Chile, Colombia y Uruguay. Por eso construimos un módulo específico para Odoo que resuelve el ciclo completo de cobro recurrente con Mercado Pago como medio de pago.

El dolor: cobrar mes a mes sin perseguir clientes

El problema concreto que vemos en PyMEs LATAM con modelos de cobro recurrente tiene siempre la misma forma:

  • Un Excel (o varios) con la lista de socios o suscriptores activos.
  • Alguien está generando facturas manualmente cada inicio de mes.
  • Envíos de link de pago por WhatsApp o mail uno por uno.
  • Revisión manual del extracto de Mercado Pago para tildar quién pagó.
  • Decisiones manuales: a quién suspendo, a quién doy una semana más, a quién reactivo.

Esto no es un problema de motivación del equipo administrativo. Es un problema de proceso: el flujo natural del cobro recurrente exige automatización, y forzar trabajo humano repetitivo encima genera errores, fuga de ingresos y mala experiencia para el cliente.

Cómo funciona el módulo técnicamente

El módulo se apoya en la API de Mercado Pago, que es el mecanismo oficial de MP para autorizaciones de cobro recurrente. El flujo end-to-end queda así:

1. Alta de la suscripción

Desde Odoo se crea el contrato o suscripción del cliente con su plan, monto, frecuencia (mensual, trimestral, anual) y fecha de inicio. El módulo genera el token de pago contra MP.

2. Autorización única

El cliente entra al link, se loguea en Mercado Pago y autoriza el cobro recurrente con la tarjeta de su preferencia. Esa autorización queda vigente hasta que el cliente la revoque o la suscripción se cancele desde Odoo.

3. Cobro automático mensual

En cada ciclo, MP ejecuta el cobro y notifica el resultado al módulo vía webhook. Odoo registra el pago, genera la factura correspondiente y actualiza el estado de la suscripción. Si el cobro falla (fondos insuficientes, tarjeta vencida), MP reintenta según su política y el módulo deja la suscripción en estado de revisión.

4. Conciliacion

Los pagos quedan conciliados contra las facturas dentro de Odoo, en la cuenta contable correspondiente. No hay que cruzar el extracto de MP a mano: el webhook llega con el ID de la transacción y el módulo cierra el círculo.

5. Reactivación o cancelación

Según la regla de negocio que configures (cuántos intentos fallidos hasta suspender, si reactiva automáticamente al cobrar, si requiere acción manual), el módulo gestiona el ciclo de vida de la suscripción sin intervención.

Qué problema NO resuelve este módulo

Aclara esto porque genera confusión recurrente cuando los clientes nos preguntan: este módulo no es una sincronización con la app "Mercado Pago Suscripciones". No vamos a leer las suscripciones que vos diste de alta en el panel de MP y replicarlas en Odoo.

Lo que hace el módulo es lo contrario: las suscripciones viven y se gestionan en Odoo. Mercado Pago es el medio de cobro que se usa por debajo, vía su API. La fuente de verdad del estado del cliente, el plan, las facturas, la contabilidad y la operatoria comercial es Odoo.

Esta distinción importa porque muchos negocios empiezan armando las suscripciones a mano en el panel de MP y después quieren llevar todo al ERP. El camino correcto es al revés: que el ERP sea quien orquesta, y MP sea el procesador.

Casos de uso típicos

Donde vemos que este módulo encaja naturalmente:

  • Gimnasios y centros deportivos: cuota mensual de socio, con suspensión automática si el cobro falla y reactivación al regularizar.
  • Academias y formacion continua: cohortes con pago mensual durante la cursada, o membresías anuales con cobro recurrente.
  • SaaS B2B: facturación mensual o anual de planes, con upgrade/downgrade manejado desde Odoo Sales y cobro vía MP.
  • Servicios profesionales con retainer: agencias, estudios contables, consultoras que cobran un fee mensual fijo.
  • Cajas de suscripción de productos físicos: donde la cuota mensual habilita el envío del periodo siguiente.
  • Comunidades pagas y membresías: acceso a contenido, eventos o servicios atado al cobro al día.

Cómo empezar la implementación con Epik

Si ya tenés Odoo Enterprise andando, la implementación del módulo es relativamente rápida. Los pasos:

  • Cuenta de Mercado Pago Developers: necesitas tener (o crear) tu cuenta en developers.mercadopago.com y solicitar habilitación del producto para tu país. Esto es un requisito de MP, no de Epik.
  • Credenciales y webhook: generamos las credenciales de producción y configuramos el conector que recibe las notificaciones de cobro en tu instancia de Odoo.
  • Modelado de planes: definimos en Odoo los productos/planes recurrentes, montos, periodicidad y reglas de suspensión/reactivación según tu negocio.
  • Migración (si aplica): si ya tenés suscripciones activas en Excel o en otro sistema, las migramos al módulo y enviamos a cada cliente el link de reautorización en MP.
  • Puesta en marcha y soporte: arrancamos con un grupo piloto, validamos el ciclo completo (cobro, conciliación, suspensión, reactivación) y escalamos al resto de la base.

Si querés avanzar con esto en tu PyME, escribinos a [email protected] o desde el formulario de contacto en epik.uy. 

Preguntas frecuentes

El módulo se integra con la app Mercado Pago Suscripciones?

No. El módulo no lee ni sincroniza con la app Suscripciones de Mercado Pago. Las suscripciones se gestionan dentro de Odoo y se cobran usando la API de preapproval de MP como medio de pago.¿

En qué países funciona?

En cualquier país donde Mercado Pago habilita el producto preapproval, lo que hoy cubre Argentina, México, Chile, Colombia, Uruguay, Brasil y Perú. La habilitación concreta depende de tu cuenta de MP y del país de operación.

Qué pasa si un cobro mensual falla?

El módulo recibe la notificación del intento fallido vía webhook. Según la regla configurada (cantidad de reintentos, días de gracia), deja la suscripción en estado de revisión, suspende automáticamente o notifica al equipo de cobranzas para acción manual.¿

Necesito Odoo Enterprise o sirve con Community?

El módulo está pensado para Odoo Enterprise, que es la versión sobre la que trabajamos como partner oficial. Eso garantiza compatibilidad con los módulos contables, de facturación electrónica y de suscripciones del stack Enterprise.¿

Cuánto tiempo lleva una implementación típica?

Si ya tenés Odoo Enterprise andando y la cuenta de MP habilitada, una implementación estándar arranca a producir en 2 a 4 semanas, dependiendo del volumen de planes y de la migración de la base existente.

Odoo para acopio de granos: cómo funciona y qué le agrega Epik
Gestión integral de acopio, contratos a fijar y liquidaciones sobre Odoo 18, pensado para acopios y cooperativas