MercadoPago en WooCommerce es el impuesto silencioso del e-commerce en LATAM. Hay un plugin oficial, tres forks mantenidos a medias, cinco abandonados, y la mitad de los threads de Stack Overflow son de 2019. Acá está lo que realmente funciona en 2026.
Usá el plugin oficial — pero pineá la versión
Mercado Pago Payments for WooCommerce (by Mercado Pago, ~400k instalaciones activas) es el que querés. Cubre Checkout Pro, Checkout Transparente, Pix, y cuotas sin interés. Pineá la versión en el sitio del cliente — las auto-actualizaciones en plugins de pago son la forma de despertarte con el checkout roto a las 9am.
Keys y webhooks, el setup real
Necesitás cuatro credenciales (Public Key + Access Token, para test y prod) y una URL de webhook apuntando a tu tienda. El webhook es el que todos se olvidan. Sin él, los pagos pueden aprobarse en MP y WooCommerce nunca marca la orden como pagada — el cliente devuelve plata, se queja, vos quedás mal.
- —Webhook URL: https://tu-sitio.com/wc-api/WC_WooMercadoPago_Basic_Gateway/
- —Activalo en MP Dashboard → Developers → Tu Aplicación → Webhooks
- —Suscribite a los eventos 'payments' (como mínimo)
- —Loggeá los webhooks entrantes durante el setup — usamos WP Webhook Logger para esto
Un correo breve cada pocas semanas. Como esta nota, pero en tu inbox.
Sandbox sin romper prod
El ambiente test de MP usa credenciales separadas y usuarios de prueba separados con tarjetas falsas. Nunca testees con credenciales en vivo, por más urgente que sea. Creá dos test users (uno comprador, uno vendedor) en el panel de developers de MP — usá las tarjetas de test de su docs. Una orden real desde tu celular NO es un test.
"La mitad de los tickets de MercadoPago que debuggeamos vinieron de alguien corriendo un 'test real' de $1 con credenciales de prod a las 2am."
Fallos comunes
- —Cuotas sin interés muestra mal: casi siempre es un mismatch de promo/marketplace-agreement del lado MP, no WooCommerce
- —La orden queda 'pending' para siempre: el webhook no llegó (mirá los logs) o el endpoint devolvió non-200
- —El checkout redirige a MP, el usuario paga, cae en una página en blanco: return URL mal configurado en el plugin
- —Pagos dobles: el usuario abrió el checkout en dos pestañas. Habilitá 'one-click' para reducirlo
Cuándo NO usar MP
Si ≥70% de tu carrito es fuera de LATAM, Stripe es mejor default. Si vendés SaaS por suscripción con clientes internacionales, Stripe de nuevo. MP brilla cuando tus compradores son mayoritariamente argentinos, mexicanos, brasileños, colombianos o chilenos — es el checkout en el que confían y la app ya la tienen. En cualquier otro lado es fricción.