# Conectar Mercado Pago en Lueira

> Guía paso a paso para conectar tu cuenta de Mercado Pago a Lueira y cobrar en tu tienda online: qué datos necesitas, de dónde sacarlos en Mercado Pago y dónde pegarlos en Lueira.

## Conectar Mercado Pago en Lueira

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 [support@lueira.com](mailto:support@lueira.com) 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.

![Vista previa a tamaño completo](https://media.support.lueira.com/images/fd30654a4f5c64a8cc402cf3c7a81609.png)

1. Entra en [Mercado Pago Developers](https://www.mercadopago.com.ar/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.
   ​
2. Pulsa **Integraciones**, arriba a la derecha. Se abrirá la pantalla **Gestión de integraciones**, donde aparecen tus aplicaciones.
   ​
3. 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.
   ​ ![Vista previa a tamaño completo](https://media.support.lueira.com/images/fd30654a4f5c64a8cc402cf3c7a81609.png)
4. 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.
   ​ ![Vista previa a tamaño completo](https://media.support.lueira.com/images/ba511704dbb3e027756cfbc8b3b27efe.png)
5. Despliega el apartado **Otros datos** y comprueba que **Tipo de API** es **API de Preferences**. Viene así por defecto: no lo cambies.
   ​ ![](https://media.support.lueira.com/images/881314866b6280b4ca2ffe23e22e76a5.png)
6. 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»).
   ​ ![](https://media.support.lueira.com/images/18aac3a3c9998f0c8cfb2ec43ac0b61e.png)
7. Marca la casilla de autorización (Declaración de Privacidad y Términos y condiciones).
   ​
8. 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**.
​

![](https://media.support.lueira.com/images/ae7a35e5c574d3320ba93f2f173b993b.png)

1. 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**.
   ​
2. 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.
   ​
3. Verás cuatro datos: **Public Key**, **Access Token**, **Client ID** y **Client Secret**. Lueira solo necesita la **Public Key** y el **Access Token**.
   ​
4. 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.

![](https://media.support.lueira.com/images/c5828480f2291937aa2207cb51ced451.png)

💡 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

1. En Lueira, ve a **Configuración > Pagos** y busca la tarjeta **MercadoPago**. Pulsa el botón para conectarla.
   ​ ![](https://media.support.lueira.com/images/b586ed2674789f9a5c7144fefe095df3.png)
2. Se abrirá la ventana **Credenciales de MercadoPago**. Pega la **Public key** y el **Access token** que copiaste en el paso 2.
   ​ ![](https://media.support.lueira.com/images/938a24e9ca30660710efc505a67671fe.png)
3. Deja vacío el campo **Clave secreta del webhook**: es opcional y la añadiremos en el paso 4.
   ​
4. Asegúrate de que el interruptor **Modo pruebas** está **desactivado**. Con el modo pruebas activado no se admiten pagos reales.
   ​
5. 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.

![](https://media.support.lueira.com/images/5e3625606034af2381e435972aab78b9.png)

## 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.

1. En Lueira, en la tarjeta MercadoPago, copia la **URL de notificaciones** con el icono de copiar que hay a su lado.
   ​
2. 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».
   ​
3. Pulsa **Configurar notificaciones**. ![](https://media.support.lueira.com/images/23152dbf8bff8f5464d7725b4ce1cd4c.png)
4. 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**.
   ​
5. Pega la URL de notificaciones de Lueira en el campo de la URL.
   ​
6. 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.
   ​
7. Pulsa **Guardar**, al final del formulario.
   ​
8. Al guardar, Mercado Pago genera la **Clave secreta** y la muestra en el campo «Clave secreta», al final del formulario. Cópiala.
   ​
9. 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](lueira-guide:b6cf255e-c386-4155-baf9-e56b38282676?locale=es).
​

## Opcional: probar antes de cobrar de verdad

Si quieres simular un pago sin usar dinero real:

1. 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.
   ​
2. En Lueira, pulsa **Editar credenciales**, pega esas claves, **activa el Modo pruebas** y pulsa **Guardar**. La tarjeta mostrará la etiqueta **Pruebas**.
   ​
3. 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.
   ​
4. 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á.
   ​
5. 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.
​

## Artículos relacionados

- [Métodos de pago y pasarelas en Lueira](lueira-guide:fe5cb5ff-cf48-4c59-99e3-245ea93316df?locale=es) — resumen de todos los métodos de pago disponibles.
- [Configuración tienda online](lueira-guide:b6cf255e-c386-4155-baf9-e56b38282676?locale=es) — cómo activar y configurar tu tienda online.
- [Ciclo de vida del pedido: estados, pago y confirmación](lueira-guide:a6670508-e27f-495f-84d8-a0b99ae12b29?locale=es) — cómo se relacionan los estados del pedido y del pago.

Source: https://help.lueira.com/es/articles/conectar-mercado-pago-en-lueira