8 pasos para integrar Mercado Pago en WooCommerce Argentina

Por qué usar Mercado Pago en tu tienda WooCommerce

Si tenés una tienda online en Argentina, Mercado Pago no es una opción más entre varias. Es el medio de pago que tu cliente ya conoce, que ya usa para otras compras y en el que ya confía. No tenerlo disponible en el checkout es básicamente dejar la puerta abierta al abandono del carrito justo en el momento más crítico.

WooCommerce es la plataforma de e-commerce que encontramos con mayor frecuencia cuando trabajamos con tiendas locales. La combinación tiene sentido técnico y comercial: WooCommerce da la estructura, Mercado Pago aporta la conversión.

Lo que diferencia a Mercado Pago de otras pasarelas disponibles localmente es la amplitud de su ecosistema. Tarjetas de crédito y débito de todos los bancos, pagos en cuotas, Mercado Crédito, QR, transferencias y billetera propia. Cubrir todo eso con un solo plugin simplifica bastante la operación.

Requisitos previos antes de empezar

Antes de instalar cualquier plugin, necesitás tener resueltas algunas cosas. Arrancar sin estos elementos en orden genera problemas que después son difíciles de diagnosticar y, en algunos casos, difíciles de atribuir a una causa concreta.

• Cuenta de Mercado Pago verificada: necesitás una cuenta de vendedor con el CUIT o CUIL asociado. Sin verificación, las credenciales de producción no están disponibles.
• WooCommerce activo y actualizado: usá siempre la versión estable más reciente. El plugin oficial de Mercado Pago tiene requisitos de versión mínima que cambian con cada actualización.
• SSL activo en tu dominio: tu sitio tiene que correr bajo HTTPS. Ninguna pasarela de pago seria funciona sobre HTTP.
• WordPress con permisos de administrador: parece obvio, pero en sitios gestionados por terceros esto a veces no está garantizado.
• PHP actualizado: revisá que tu servidor corra una versión de PHP compatible con las versiones actuales de WordPress y WooCommerce. Tu hosting lo informa desde el panel de control.

Si tu tienda todavía está en etapas tempranas y necesitás pensar el proyecto desde cero, en nuestra sección de diseño web para e-commerce encontrás cómo encaramos este tipo de proyectos.

Instalar el plugin oficial de Mercado Pago

El plugin que tenés que usar es el oficial: Mercado Pago payments for WooCommerce, publicado por la propia empresa en el repositorio de WordPress.org. Evitá plugins de terceros que prometan lo mismo. Suelen quedar desactualizados cuando Mercado Pago cambia su API, y eso puede dejar tu checkout roto sin que te enteres hasta que un cliente te avisa.

El proceso de instalación es el estándar de cualquier plugin de WordPress:

1. Ingresá al panel de administración de WordPress.
2. Ir a Plugins > Agregar nuevo.
3. Buscá 'Mercado Pago' en el buscador.
4. Instalá el plugin que aparece como desarrollado por 'Mercado Pago'.
5. Una vez instalado, hacé clic en Activar.

Después de activarlo, vas a ver una nueva entrada en el menú lateral llamada 'Mercado Pago'. Ese es el punto de entrada para toda la configuración que viene.

Configurar las credenciales y el modo de pago en Argentina

Acá es donde más errores se cometen. Las credenciales son las llaves que conectan tu tienda con tu cuenta de Mercado Pago, y hay dos sets distintos: las de prueba (sandbox) y las de producción. No las mezcles, porque el plugin no siempre advierte el error con un mensaje claro.

Cómo obtener tus credenciales:

1. Ingresá a mercadopago.com.ar con tu cuenta de vendedor.
2. Andá a Tu negocio > Configuración > Gestión y administración > Credenciales.
3. Vas a ver dos pestañas: Credenciales de prueba y Credenciales de producción. Copiá el Public Key y el Access Token de cada una por separado.

Cómo cargarlas en el plugin:

1. Dentro del panel de WordPress, ir a Mercado Pago > Credenciales.
2. Pegá las credenciales de prueba en los campos correspondientes y guardá.
3. Configurá los métodos de pago que querés ofrecer: checkout pro (redirección), checkout transparente (formulario en tu sitio) o pagos offline como Rapipago y Pago Fácil.
4. Definí si ofrecés cuotas sin interés y cuántas. Esto se administra desde tu cuenta de Mercado Pago, no desde el plugin.

El checkout transparente requiere un nivel de validación mayor de tu cuenta. En Xulum nos pasó que clientes que arrancaban con una cuenta nueva no lo tenían habilitado desde el primer día. Si ese es tu caso, empezá con Checkout Pro y avanzá desde ahí.

Probar la integración antes de salir en vivo

Nunca actives las credenciales de producción sin haber hecho al menos una compra de prueba completa. Mercado Pago te da usuarios y tarjetas de test específicas para esto. El flujo de prueba replica exactamente lo que va a vivir tu cliente real.

• Crear usuarios de prueba: desde la sección de credenciales en Mercado Pago podés generar un usuario comprador y un usuario vendedor de prueba. Son cuentas ficticias que solo sirven para el sandbox.
• Usar tarjetas de prueba: Mercado Pago publica en su documentación oficial una lista de números de tarjeta para simular aprobaciones, rechazos y pagos pendientes.
• Verificar el flujo completo: agregá un producto al carrito, avanzá hasta el pago, completá el formulario con los datos de prueba y confirmá que el pedido pasa al estado correcto en WooCommerce.
• Revisar los webhooks: confirmá que WooCommerce recibe las notificaciones de pago. Si el estado del pedido no cambia automáticamente, hay un problema de comunicación entre servidores que hay que resolver antes de salir a producción.

Una vez que el flujo de prueba funciona sin errores, volvé a las credenciales del plugin, reemplazá las de prueba por las de producción y verificá que el modo esté en 'Producción' antes de cerrar.

Errores frecuentes al integrar Mercado Pago en WooCommerce

Algunos problemas aparecen casi siempre. Lo que vemos seguido en proyectos de clientes es que la mayoría de estos errores no tienen nada de misterioso una vez que sabés dónde mirar.

Credenciales cruzadas: pegar el Access Token de prueba en el campo de producción, o al revés, es el error más común. El plugin no siempre lo advierte con claridad; simplemente el pago falla. Es lo primero que hay que revisar.

SSL mal configurado: tener un certificado instalado no garantiza que el sitio funcione bien en HTTPS. Revisá que no haya contenido mixto (imágenes o scripts que cargan en HTTP) con herramientas como Why No Padlock o la consola del navegador.

Caché agresivo: muchos hostings y plugins de caché guardan versiones estáticas del checkout, lo que rompe el flujo de pago. Excluí las páginas de carrito, checkout y cuenta de usuario de cualquier sistema de caché.

Conflictos con plugins de seguridad: algunos bloquean las llamadas entrantes de Mercado Pago. Si los pedidos no cambian de estado automáticamente después del pago, revisá los logs de tu firewall antes de buscar el problema en otro lado.

Cuenta sin verificar: aplica especialmente para tiendas que arrancaron hace poco. Las credenciales de producción de una cuenta no verificada tienen restricciones operativas que pueden hacer que los pagos fallen sin un mensaje de error claro para el comprador.