Suscripciones y Pagos Recurrentes con Mercado Pago para WooCommerce

El plugin gratuito conecta productos simples de WooCommerce con suscripciones de Mercado Pago. Permite crear planes recurrentes, consultar su estado, sincronizar pagos y ofrecer al cliente un historial en Mi cuenta. No requiere WooCommerce Subscriptions. No guarda números de tarjeta ni CVV en WordPress: el comprador autoriza el medio de pago en Mercado Pago.

Antes de empezar

• WordPress 6.2 o superior, PHP 7.4 o superior y WooCommerce activo.
• Sitio con HTTPS público y enlaces permanentes funcionando. Mercado Pago debe poder llegar al sitio para notificar pagos.
• Cuenta de Mercado Pago del comercio con acceso a suscripciones y una aplicación en Tus integraciones.
• Productos y precios de prueba preparados. No probar primero con un pedido real.

[CAPTURA CORE-01] Plugins > Plugins instalados: mostrar WooCommerce y el core activos. Ocultar otros plugins irrelevantes.

1. Instalar y activar

1. En WordPress, ir a Plugins > Añadir nuevo > Subir plugin.
2. Seleccionar el ZIP del core o instalarlo desde el repositorio de WordPress cuando esté publicado.
3. Activarlo y abrir Inobarix > Inicio. Las tarjetas muestran suscripciones activas, casos que requieren atención y total histórico.
4. Si aparece un aviso de configuración pendiente, abrir Inobarix > Estado antes de vender.

[CAPTURA CORE-02] Inobarix > Inicio: encabezado, métricas y aviso de configuración, con cifras de ejemplo.

2. Conectar Mercado Pago

1. Obtener las claves siguiendo Conseguir las credenciales de Mercado Pago (ver artículo relacionado).
2. Ir a Inobarix > Ajustes > Pagos recurrentes.
3. Activar el método y completar Public key de producción y Access token de producción. Si se harán pruebas, completar también los campos de prueba.
4. Elegir Entorno de credenciales. Prueba y producción son entornos distintos: confirmar cuál está seleccionado antes de vender.
5. Revisar título, descripción y logo del medio de pago; guardar.
6. En WooCommerce > Ajustes > Pagos, comprobar que el método esté habilitado. Luego revisar Inobarix > Estado.

El plugin envía una URL segura de notificación al crear cada pago o suscripción; normalmente no hay que pegar manualmente una URL de webhook. Webhook secret es opcional y solo corresponde si también configuraste el webhook global para esa misma aplicación de Mercado Pago. No inventes ni reutilices la clave de otra aplicación.

[CAPTURA CORE-03] Inobarix > Ajustes > Pagos recurrentes: vista general de los campos, con todas las claves totalmente tapadas. [CAPTURA CORE-04] Inobarix > Estado: conexión y diagnósticos, usando una instalación de prueba sin errores.

3. Crear el primer producto recurrente

1. En Productos > Añadir nuevo, crear un producto simple con nombre, descripción y precio. El importe debe coincidir con la cuota que se quiere cobrar.
2. En los datos del producto, activar Suscripción Mercado Pago.
3. Configurar Intervalo de cobro y Unidad de cobro. Por ejemplo, 1 y Meses para una cuota mensual.
4. Si el plan termina después de cierta cantidad de cobros, configurar Finalizar después de ciclos. Con 0 o vacío no tiene una finalización definida.
5. Guardar y abrir la ficha pública. Comprobar el precio, la periodicidad y el botón Suscribirme ahora.

No marques como recurrente un producto que solo debería cobrarse una vez. El core no convierte automáticamente todas las compras de WooCommerce en suscripciones.

[CAPTURA CORE-05] Editor del producto: precio, casilla Suscripción Mercado Pago, intervalo, unidad y ciclos, todos visibles. [CAPTURA CORE-06] Ficha pública del producto: precio por período y botón de suscripción.

4. Hacer una compra de prueba

1. Con el entorno de prueba configurado, abrir la tienda como comprador de prueba, sin sesión de administrador.
2. Comprar el producto recurrente y completar la autorización en Mercado Pago.
3. Volver a la tienda y comprobar el pedido, Inobarix > Suscripciones y Mi cuenta > Suscripciones.
4. Verificar en Mercado Pago que la suscripción y el pago esperado tengan el estado correcto. Los estados pueden tardar unos minutos en sincronizarse.
5. Repetir con el escenario de pago rechazado si la cuenta de prueba lo permite.

No asumir que un pedido creado equivale a un cobro aprobado. Para despachar o dar acceso, verificar estado de pago y suscripción.

[CAPTURA CORE-07] Checkout de prueba antes de ir a Mercado Pago, sin datos personales. [CAPTURA CORE-08] Inobarix > Suscripciones: una suscripción de prueba y su estado. [CAPTURA CORE-09] Mi cuenta del comprador: detalle de suscripción e historial, con datos anonimizados.

5. Trabajo diario

• Inobarix > Suscripciones: revisar activas, rechazadas, pausadas o canceladas; abrir un detalle antes de cambiar algo.
• Sincronizar: consultar Mercado Pago cuando un estado parezca atrasado. No repetir pagos manualmente solo porque la pantalla tardó en actualizar.
• Inobarix > Estado: revisar conexión, tareas programadas, tablas y avisos técnicos.
• WooCommerce > Pedidos: distinguir el pedido inicial de los cobros posteriores. Un pago recurrente no siempre genera un nuevo pedido físico; para eso existe la extensión de envíos.
• Inobarix > Soporte: abrir una consulta y adjuntar IDs de prueba o capturas sin secretos.

[CAPTURA CORE-10] Detalle administrativo de una suscripción: estado, próximo cobro e historial.

Preguntas frecuentes

¿Puedo fijar el día 10 para todos? El core básico cobra según la frecuencia del producto. La fecha fija para nuevas suscripciones está en Cobros avanzados; no reprograma automáticamente suscripciones viejas.

¿Dónde están los datos de tarjeta? En Mercado Pago. No pidas al cliente el número de tarjeta ni el CVV por correo o soporte.

¿Por qué un pedido no figura como pagado? Puede faltar la aprobación en Mercado Pago o la notificación. Verificar el pago remoto, el estado local y los diagnósticos antes de actuar.

¿Cómo pruebo sin afectar compradores reales? Usar credenciales y compradores de prueba en un sitio de pruebas. Pasar a producción solo tras verificar el circuito completo.