Esta guía explica cómo obtener las claves que pide Inobarix > Ajustes > Pagos recurrentes. Deben pertenecer a la cuenta de Mercado Pago que recibirá los cobros. El aspecto del panel de Mercado Pago puede variar; ante una diferencia, buscar la sección Tus integraciones de la misma aplicación.
Qué clave va en cada campo
| En WordPress | En Mercado Pago | Uso |
|---|---|---|
| Public key de producción | Public Key de producción | Identifica la integración pública en ventas reales. |
| Access token de producción | Access Token de producción | Clave privada para llamadas del servidor y cobros reales. |
| Public key de prueba | Public Key de prueba | Identifica la integración en pruebas. |
| Access token de prueba | Access Token de prueba | Clave privada para llamadas de prueba. |
| Webhook secret, opcional | Clave secreta de Webhooks | Validación del webhook global, si se configuró. |
Access Token no es Client Secret. Nunca publiques el Access Token ni el Webhook secret en una captura, ticket o repositorio. La Public Key también debe ocultarse en capturas de soporte para evitar confusiones entre cuentas.
1. Crear o elegir una aplicación
- Iniciar sesión en la cuenta de Mercado Pago del comercio y abrir Tus integraciones.
- Elegir la aplicación de esta tienda. Si no existe, crear una aplicación siguiendo el asistente de Mercado Pago y seleccionar la solución que corresponda al checkout usado.
- Mantener una sola aplicación coherente para las credenciales de esa tienda. No mezclar una Public Key de una aplicación con un Access Token de otra.
[CAPTURA MP-01] Mercado Pago Developers > Tus integraciones: listado de aplicaciones, con nombres internos anonimizados.
2. Obtener credenciales de prueba
- Abrir la aplicación y entrar en Credenciales de prueba. Mercado Pago puede mostrar la ruta dentro de Datos de integración > Pruebas.
- Activarlas si el panel lo solicita.
- Copiar la Public Key y el Access Token de prueba en los campos correspondientes de Inobarix.
- Guardar los ajustes y elegir Prueba en Entorno de credenciales.
[CAPTURA MP-02] Menú de la aplicación con Credenciales de prueba resaltado. Mostrar los nombres de campos, nunca sus valores. [CAPTURA MP-03] WordPress: correspondencia entre los dos campos de prueba y el selector de entorno, con valores tapados.
3. Obtener credenciales de producción
- En la misma aplicación abrir Credenciales de producción. Es posible que Mercado Pago pida activar las credenciales y completar datos del negocio.
- Copiar la Public Key y el Access Token de producción a sus campos en WordPress.
- Guardar sin cambiar todavía a producción. Primero realizar las pruebas indicadas en la guía del core.
- Cuando el circuito esté verificado, seleccionar Producción, guardar y realizar una compra controlada de importe bajo con el consentimiento del comercio.
Un token de prueba no sirve como reemplazo del token de producción de la cuenta real. No se deben mezclar vendedores ni aplicaciones.
[CAPTURA MP-04] Credenciales de producción: ubicación de Public Key y Access Token, ambos ocultos por completo. [CAPTURA MP-05] WordPress: selector de producción y botón Guardar, con claves ocultas.
4. Notificaciones y Webhook secret
El core envía a Mercado Pago una URL de notificación segura al crear cada pago o suscripción. Por eso no es obligatorio configurar un webhook global para la instalación básica.
Si el equipo decide configurar también un webhook global, hacerlo en Tus integraciones > [aplicación] > Webhooks > Configurar notificaciones y revelar allí la clave secreta de esa aplicación. Copiarla únicamente al campo Webhook secret del plugin y verificar los tópicos necesarios. La URL configurada al crear un pago puede tener prioridad sobre la URL global. No pegar el Access Token en este campo.
[CAPTURA MP-06] Sección Webhooks de Mercado Pago con el botón de configuración; clave secreta completamente tapada.
Comprobación y errores habituales
- Abrir Inobarix > Estado y revisar credenciales, conexión y avisos.
- Hacer una autorización de prueba con un comprador de prueba, no con la cuenta vendedora.
- Comparar el estado de la operación en Mercado Pago con el de la suscripción en WordPress.
- Credenciales inválidas: comprobar que Access Token y Public Key sean de la misma aplicación y del entorno elegido.
- No aparecen pagos: confirmar la cuenta vendedora, la autorización del cliente y la recepción de notificaciones; no crear pagos duplicados para investigar.
- El sitio no recibe webhooks: comprobar HTTPS público, firewall, mantenimiento, caché y diagnóstico del plugin.
- Modo prueba cobra o muestra datos inesperados: detener las pruebas y confirmar vendedor, comprador y entorno antes de continuar.
Fuentes oficiales
- Credenciales y diferencia entre Public Key y Access Token.
- API de creación de suscripciones.
- Notificaciones y tópicos.
- Configuración y firma de Webhooks.
Revisar estas páginas si Mercado Pago cambia nombres de menú o requisitos para activar producción.