Cómo configurar Mercado Pago en WooCommerce: tutorial paso a paso

Si tenés una tienda en WordPress y querés cobrar online en Uruguay, el camino más usado es configurar Mercado Pago en WooCommerce. Es una integración sólida, hay plugin oficial mantenido por MP y permite ofrecer todos los medios de pago locales (tarjetas, débito, transferencia, Redpagos y Abitab) sin tener que codear nada.

En esta guía vamos paso a paso: desde instalar el plugin hasta dejar los webhooks IPN funcionando y testear en sandbox antes de salir al aire. Si te trabaste en algún punto de la integración, vas a encontrar acá la respuesta.

Antes de empezar: requisitos previos

Asegurate de tener estas cosas listas antes de tocar el plugin:

• WordPress y WooCommerce actualizados a la última versión estable.
• Una cuenta de Mercado Pago verificada en mercadopago.com.uy (operando como persona física o jurídica según corresponda).
• Tu RUT y datos fiscales dados de alta en MP, sobre todo si vas a facturar electrónicamente desde tu tienda.
• HTTPS activo en tu sitio. Sin SSL, MP no te deja cobrar en producción.
• Acceso al hosting (panel cPanel, Plesk o similar) por si tenés que subir el plugin manualmente.

Con estos checks en orden, la instalación lleva minutos. Sin ellos, vas a tener errores raros más adelante.

Paso 1: instalar el plugin oficial

Hay dos formas de instalar el plugin “Mercado Pago payments for WooCommerce”.

Desde el panel de WordPress:

1. Ingresá al panel de admin de tu sitio.
2. Andá a Plugins → Añadir nuevo.
3. Buscá “Mercado Pago payments for WooCommerce”.
4. Verificá que el desarrollador sea “Mercado Pago” (el logo oficial). Hay clones que conviene esquivar.
5. Hacé clic en “Instalar ahora” y luego en “Activar”.

Manualmente (si tu hosting bloquea instalaciones directas):

1. Descargá el plugin desde WordPress.org.
2. Subilo a wp-content/plugins/ vía FTP o el administrador de archivos de cPanel.
3. Activalo desde el panel.

Una vez activado, vas a ver una nueva sección en WooCommerce → Configuración → Pagos.

Paso 2: obtener credenciales en el panel de MP

Mercado Pago usa dos pares de credenciales: las de prueba (test) y las de producción.

Para conseguirlas:

1. Iniciá sesión en mercadopago.com.uy con la cuenta del negocio.
2. Andá a Tu negocio → Desarrolladores.
3. Hacé clic en “Tus integraciones” y creá una aplicación nueva. Le ponés un nombre (ej: “Tienda WooCommerce”) y elegís el tipo de producto: “Cobros en línea”.
4. Una vez creada, vas a ver dos pestañas: Credenciales de prueba y Credenciales de producción.

Cada pestaña te da:

• Public Key: la clave pública, va en el frontend.
• Access Token: la clave secreta, va en el backend. Nunca la publiques en GitHub ni la pongas en el código frontend.

Anotá las cuatro credenciales (dos de prueba, dos de producción) en un gestor de contraseñas seguro.

Paso 3: conectar el plugin con tu cuenta MP

En WooCommerce → Configuración → Pagos, vas a ver “Mercado Pago” en la lista. Hacé clic en “Configurar” o “Gestionar”.

El plugin te va a dar dos opciones:

• Conectar con OAuth: ingresás a tu cuenta MP y autorizás la conexión. Es la opción más simple y la recomendada.
• Ingresar credenciales manualmente: pegás Public Key y Access Token.

Te recomiendo OAuth si tenés acceso a la cuenta de MP del negocio. Es más seguro y se renueva sin que tengas que tocarlo cada cierto tiempo.

Paso 4: elegir el tipo de checkout

El plugin oficial ofrece dos modos principales:

• Checkout Pro: el cliente sale de tu sitio a MP, paga ahí y vuelve. Mínima configuración, máxima compatibilidad.
• Checkout Personalizado (Transparente): el pago se completa en tu sitio sin redirección. Más control, más mantenimiento.

Para el 90% de las tiendas en Uruguay, Checkout Pro es lo que conviene. Tiene mejor tasa de aprobación, MP actualiza solo los medios y baja la responsabilidad de seguridad de tu lado.

Activá los métodos que querés ofrecer al cliente:

• Pago con tarjeta.
• Pago con dinero en cuenta MP.
• Pago con transferencia bancaria.
• Pago en efectivo (Redpagos/Abitab).

Cada método se puede activar o desactivar independientemente.

Paso 5: configurar modo sandbox para probar

Antes de salir al aire, siempre hay que probar en sandbox. El plugin tiene un switch claro: “Modo prueba” o “Modo producción”.

Para sandbox:

1. Activá el toggle de “Modo prueba”.
2. Pegá tus credenciales de test (no las de producción).
3. Guardá los cambios.

MP te da cuentas de prueba (una de vendedor y una de comprador) y tarjetas de testing con resultados controlados:

• Tarjeta que aprueba siempre.
• Tarjeta que rechaza por fondos insuficientes.
• Tarjeta que pide 3D Secure.
• Tarjeta que queda en estado pendiente.

Con esto cubrís los casos principales y te asegurás de que tu tienda reacciona bien a cada uno.

Paso 6: configurar los webhooks IPN

Acá es donde muchas tiendas se traban. Los webhooks (IPN o Notificaciones de Pago Instantáneo) son los avisos que MP manda a tu sitio cuando un pago cambia de estado.

El plugin oficial expone una URL del tipo:

https://tutienda.com.uy/wc-api/WC_WooMercadoPago_Notification/

Esta URL la tenés que configurar en dos lados:

1. Dentro del plugin de WooCommerce: en general ya viene puesta sola, pero verificá que esté bien.
2. En el panel de MP: andá a “Desarrolladores → Webhooks” en tu aplicación de MP y pegá la URL. Seleccioná los eventos: payment (creación), payment.updated (actualización).

Para verificar que funciona, hacé una compra de prueba y mirá la sección “Notificaciones” del panel de MP. Vas a ver si MP intentó avisar y con qué código de respuesta.

Paso 7: pasar a producción

Una vez que todo funciona en sandbox:

1. Cambiá el toggle del plugin a “Modo producción”.
2. Pegá las credenciales de producción.
3. Confirmá que los webhooks apuntan a la URL real (sin staging ni localhost).
4. Hacé una compra real con tu propia tarjeta por un monto chico (USD 1 o 2 equivalentes).
5. Verificá que la compra aparece como aprobada, que llega el mail al cliente y que se descuenta el stock.
6. Si todo funcionó, devolvés ese pago desde el panel de MP y listo, estás en producción.

Errores comunes y cómo resolverlos

Estos son los problemas que más vemos en tiendas WooCommerce + MP en Uruguay.

”Auto-return: invalid”

El cliente paga pero no vuelve a tu tienda. Suele ser porque la URL de retorno está mal configurada. Verificá que el dominio del plugin coincida con el dominio real de la tienda y que esté con HTTPS.

”No llegan las notificaciones IPN”

Causas frecuentes:

• URL del webhook con typo o apuntando a localhost.
• Firewall del hosting bloqueando llamadas externas de MP.
• Plugin de cache (WP Rocket, W3 Total Cache) cacheando el endpoint del webhook.

Solución: agregar el endpoint del webhook a la lista de exclusiones del cache y verificar logs del servidor.

”Pago aprobado pero stock no se descuenta”

El estado en WooCommerce no se actualiza porque el webhook llegó pero el plugin no lo procesó. Verificá en los logs de WooCommerce (WooCommerce → Estado → Logs) si hay errores en “wc-mercadopago”.

”El cliente ve ‘Cuotas no disponibles’”

A veces el plugin no muestra las cuotas porque la configuración tiene el campo “Máximo de cuotas” en 1. Subilo a 12 y volvé a probar.

”Credenciales inválidas”

Verificá que pegaste las credenciales correctas (las de producción en producción, las de test en test) y que no copiaste espacios extra.

Conflictos con otros plugins

Plugins de cache, optimización CSS y firewalls (Wordfence, iThemes Security) pueden bloquear el flujo. Si algo no anda, desactivalos uno por uno para identificar el culpable.

Alternativas si el plugin oficial no te alcanza

Hay casos donde el plugin oficial se queda corto:

• Si necesitás cobrar en varias monedas simultáneamente.
• Si tu tienda corre un theme custom que pisa hooks de WooCommerce.
• Si tu volumen es muy alto y querés optimizaciones de UX (por ejemplo, ocultar medios según el ticket).
• Si tenés que conectar la facturación electrónica DGI directamente al webhook.

En esos casos lo que solemos hacer es desarrollar una integración a medida con la API de MP, manteniendo el plugin como respaldo pero pasando el flujo principal por código propio. Si necesitás algo a medida, en Seosur lo armamos.

Checklist final antes de salir al aire

Para que no te falte nada, este es el checklist que aplicamos:

• Plugin oficial instalado y actualizado.
• Credenciales de producción cargadas, no las de test.
• Modo “producción” activado.
• Webhooks configurados en MP y respondiendo 200.
• Compra de prueba real con tarjeta personal aprobada y devuelta.
• Compra de prueba con Redpagos completada (si activaste efectivo).
• Mails de confirmación llegando al cliente.
• Stock descontándose en estado “aprobado”, no en “iniciado”.
• Página de “pago pendiente” lista para Redpagos/Abitab.
• SSL renovado y sin warnings.

Con esto cubrís el 95% de los problemas que podrías encontrarte después.

¿Necesitás ayuda con tu e-commerce en Uruguay?

Configurar Mercado Pago en WooCommerce bien hecho es la diferencia entre una tienda que vende y una que pierde clientes en el checkout. En Seosur armamos y mantenemos e-commerce en Uruguay con MP integrado, facturación electrónica conectada y monitoreo de webhooks. Si querés que te lo armemos llave en mano o que auditemos tu integración actual, escribinos.