Con Mercado Pago puedes cobrar en tu tienda online usando tu propia cuenta de Mercado Pago (Checkout Pro): el cliente paga en la página segura de Mercado Pago y el dinero llega directamente a tu cuenta. Está disponible para Argentina, Brasil, Chile, Colombia, México, Perú y Uruguay.

La conexión se hace una sola vez y tarda unos 15 minutos. No necesitas saber programar: solo hay que crear una «aplicación» en Mercado Pago, copiar dos claves y pegarlas en Lueira. Esta guía te dice dónde hacer clic y de dónde sale cada dato.

Cómo funciona:

Para que Lueira pueda cobrar en tu nombre, Mercado Pago necesita darle permiso. Ese permiso se da con dos claves, llamadas credenciales, que Mercado Pago genera para una aplicación que creas dentro de tu cuenta.

Antes de empezar necesitas:

Una cuenta de Mercado Pago con la que quieras cobrar, del mismo país que tu empresa en Lueira.
La moneda de tu empresa en Lueira debe ser la de tu cuenta de Mercado Pago (por ejemplo, pesos argentinos (ARS) si tu cuenta es de Argentina).
Acceso de administrador a Lueira.
Dos pestañas del navegador abiertas: una con Mercado Pago y otra con Lueira. Vas a copiar datos de una y pegarlos en la otra.

💡 Si no ves la tarjeta MercadoPago en Configuración > Pagos, es posible que todavía no esté activada en tu cuenta. Escríbenos a [email protected] y la activamos.

Qué datos necesitas y de dónde salen

Este es el resumen de todo lo que vas a copiar y pegar. Más abajo tienes cada paso con detalle.

Dato	Qué es	De dónde lo sacas
Public key (obligatoria)	Clave pública de tu aplicación. Empieza por `APP_USR-`.	De Mercado Pago: Integraciones > tu aplicación > PRODUCCIÓN > Credenciales de producción.
Access token (obligatorio)	Clave privada que permite a Lueira crear los cobros en tu cuenta. También empieza por `APP_USR-`. No la compartas con nadie.	De Mercado Pago: la misma pantalla que la Public key.
URL de notificaciones (opcional)	Una dirección de Lueira, única para tu cuenta, que se registra en Mercado Pago para obtener la clave secreta.	De Lueira: Configuración > Pagos > tarjeta MercadoPago. Aparece cuando guardas las credenciales.
Clave secreta del webhook (opcional, recomendada)	Una contraseña que permite a Lueira comprobar que los avisos de pago vienen realmente de Mercado Pago. En Mercado Pago aparece como «Clave secreta».	De Mercado Pago: Integraciones > tu aplicación > NOTIFICACIONES > Webhooks > Configurar notificaciones, después de guardar la URL de notificaciones.

1. Crea una aplicación en Mercado Pago

Esta parte se hace en la web de Mercado Pago, no en Lueira. Cada negocio crea su propia aplicación dentro de su cuenta.

Entra en Mercado Pago Developers (si tu cuenta es de otro país, usa la web de Mercado Pago de tu país) e inicia sesión con la cuenta con la que quieres cobrar.
Pulsa Integraciones, arriba a la derecha. Se abrirá la pantalla Gestión de integraciones, donde aparecen tus aplicaciones.
Pulsa + Crear aplicación, arriba a la derecha. Si todavía no tienes ninguna aplicación, verás el mensaje «Creá tu primera aplicación» y el botón Crear aplicación en el centro de la pantalla.
En «Elegí una solución para integrar», marca Checkout Pro («Usa un checkout listo que redirige a Mercado Pago»). Las demás opciones no sirven para Lueira.
Despliega el apartado Otros datos y comprueba que Tipo de API es API de Preferences. Viene así por defecto: no lo cambies.
En Nombre de la aplicación, Mercado Pago propone uno automático (por ejemplo, «App-Checkout-Pro-…»). Puedes dejarlo o escribir el tuyo. Te recomendamos «Lueira - » seguido del nombre de tu negocio (por ejemplo, «Lueira - Surf Mar del Plata»).
Marca la casilla de autorización (Declaración de Privacidad y Términos y condiciones).
Pulsa Crear aplicación.

2. Copia tus credenciales de producción

Las credenciales son la «llave» que permite a Lueira cobrar en tu nombre. Mercado Pago tiene un juego para hacer pruebas y otro para cobrar de verdad. Para empezar a vender necesitas el de producción.

Dentro de tu aplicación verás un menú a la izquierda con varias secciones (PRUEBAS, NOTIFICACIONES, PRODUCCIÓN, EVALUACIÓN). En la sección PRODUCCIÓN, pulsa Credenciales de producción.
Si Mercado Pago te pide activarlas, completa el formulario que aparece (por ejemplo, la industria de tu negocio y su sitio web) y pulsa el botón para activar las credenciales de producción.
Verás cuatro datos: Public Key, Access Token, Client ID y Client Secret. Lueira solo necesita la Public Key y el Access Token.
Copia cada uno con el icono de copiar que hay a su derecha. El Access Token aparece oculto con puntos: pulsa el icono del ojo para verlo.

💡 Al final de esa pantalla, Mercado Pago ofrece «Compartir credenciales» con un desarrollador. Si otra persona va a hacer la conexión por ti, usa esa opción en lugar de mandarle las claves por email o por chat.

⚠️ Importante: no uses el Client ID ni el Client Secret, Lueira no los necesita. Y no compartas el Access Token con nadie: quien lo tenga puede operar en tu cuenta.

3. Conecta Mercado Pago en Lueira

En Lueira, ve a Configuración > Pagos y busca la tarjeta MercadoPago. Pulsa el botón para conectarla.
Se abrirá la ventana Credenciales de MercadoPago. Pega la Public key y el Access token que copiaste en el paso 2.
Deja vacío el campo Clave secreta del webhook: es opcional y la añadiremos en el paso 4.
Asegúrate de que el interruptor Modo pruebas está desactivado. Con el modo pruebas activado no se admiten pagos reales.
Pulsa Guardar.

Lueira comprobará tus credenciales con Mercado Pago. Si son correctas, la tarjeta mostrará:

Cuenta: tu país, la moneda y el identificador de tu cuenta de Mercado Pago (los rellena Lueira automáticamente).
Public key y el final del Access token (por seguridad, el token nunca se vuelve a mostrar completo).
Última verificación: la fecha y hora en que Lueira comprobó tus credenciales.
URL de notificaciones: la dirección que usarás en el paso 4.

4. Añade la clave secreta del webhook (opcional, recomendado)

Para qué sirve: cuando un cliente paga, lo hace en la página de Mercado Pago, fuera de Lueira. Mercado Pago envía después un aviso a Lueira. Con este paso, Lueira comprueba en cada aviso una firma que solo conoce Mercado Pago y descarta los que no la tengan. Es una capa extra de seguridad.

Tu tienda puede cobrar sin este paso, pero te recomendamos hacerlo. La URL de notificaciones es la dirección de Lueira que hay que registrar en Mercado Pago, y la clave secreta es lo que Mercado Pago te da a cambio.

En Lueira, en la tarjeta MercadoPago, copia la URL de notificaciones con el icono de copiar que hay a su lado.
En Mercado Pago, abre tu aplicación y en el menú de la izquierda, sección NOTIFICACIONES, pulsa Webhooks. Si aún no has configurado nada, verás el mensaje «Aún no configuraste notificaciones».
Pulsa Configurar notificaciones.
Al abrirse, Mercado Pago muestra dos pestañas: Modo de prueba y Modo productivo. Se abre primero la de prueba: cámbiate a Modo productivo.
Pega la URL de notificaciones de Lueira en el campo de la URL.
En «Eventos recomendados para integraciones con Checkout Pro», marca Pagos (en el panel puede aparecer como Pagos (legacy)). No hace falta marcar ningún otro evento.
Pulsa Guardar, al final del formulario.
Al guardar, Mercado Pago genera la Clave secreta y la muestra en el campo «Clave secreta», al final del formulario. Cópiala.
Vuelve a Lueira, pulsa Editar credenciales y pega la clave en Clave secreta del webhook. Deja el campo Access token vacío (Lueira mantiene el que ya tenía guardado) y pulsa Guardar.

5. Activa MercadoPago en tu tienda online

Si Mercado Pago es tu único procesador de pagos online, se usará automáticamente. Si tienes más de uno (por ejemplo, Lueira Pay), ve a Configuración > Tienda online > General y en Procesador de pagos elige MercadoPago.

Para más detalle sobre esta pantalla, consulta 👉 Configuración tienda online.

Opcional: probar antes de cobrar de verdad

Si quieres simular un pago sin usar dinero real:

En Mercado Pago, dentro de tu aplicación, sección PRUEBAS, abre Credenciales de prueba y copia la Public Key y el Access Token de prueba.
En Lueira, pulsa Editar credenciales, pega esas claves, activa el Modo pruebas y pulsa Guardar. La tarjeta mostrará la etiqueta Pruebas.
Necesitas pagar con un comprador que no seas tú. En la misma sección PRUEBAS, Cuentas de prueba te permite crear usuarios de prueba (vendedor y comprador), y Tarjetas de prueba te da tarjetas para pagar.
Haz una compra en tu tienda online y paga en una ventana de incógnito con el usuario comprador de prueba. Al introducir una tarjeta nueva, escribe APRO como nombre del titular y 12345678 como DNI para que el pago se apruebe. Con OTHE se rechazará.
Cuando termines, vuelve a Editar credenciales, pega las credenciales de producción, desactiva el Modo pruebas y guarda.

⚠️ No pagues con la misma cuenta de Mercado Pago con la que cobras: Mercado Pago no permite pagarte a ti mismo. Y si el usuario de prueba ya tiene una tarjeta guardada, el nombre del titular no sirve para forzar el resultado: usa una tarjeta nueva.

Conectar Mercado Pago en Lueira