> ## Documentation Index
> Fetch the complete documentation index at: https://help.chateea.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Integra Mercado Pago para aceptar pagos

> Conecta Mercado Pago con tus credenciales de producción, configura el webhook y asígnalo a tus canales de cobro.

Mercado Pago es el medio de pago que millones de personas en Latinoamérica usan a diario. Al conectarlo a tu cuenta de Chateea, tus clientes pagan con una marca que ya conocen y en su moneda local, lo que reduce la fricción en el pago y mejora la conversión. Para conectarlo necesitas tus credenciales de producción y configurar un webhook en tu panel de desarrollador de Mercado Pago.

## Por qué usar Mercado Pago

| Beneficio | Qué aporta |
| - | - |
| **Experiencia local** | Métodos de pago en los que tus clientes ya confían |
| **Más conversiones** | Menos abandono en el pago con un proveedor conocido |
| **Expansión regional** | Acceso al ecosistema de pagos de mayor crecimiento en la región |
| **Control** | Decides en qué canales de cobro aparece |

Una vez conectado, lo gestionas desde **Pagos → Integraciones** y eliges en qué canales usarlo.

## Países compatibles

Colombia, Argentina, Chile, México, Uruguay, Perú y Brasil.

## Antes de empezar

* Una cuenta de Mercado Pago con el **pago sin CVV** (CVV/CVC less) habilitado. Si no sabes si lo tienes, pregúntale al soporte de Mercado Pago.
* Acceso a tu panel de desarrollador de Mercado Pago.
* La URL del sitio web de tu negocio, por si Mercado Pago la pide al activar las credenciales de producción.

Vas a necesitar estos cuatro datos:

| Dato | Dónde se obtiene |
| - | - |
| **Public Key** (clave pública) | Credenciales de producción de tu aplicación en Mercado Pago |
| **Access Token** (token de acceso) | Credenciales de producción de tu aplicación en Mercado Pago |
| **País de la cuenta** | El país donde está registrada tu cuenta de Mercado Pago |
| **Secreto del webhook** | Lo generas tú; debe ser idéntico en Chateea y en Mercado Pago |

> [!WARNING]
>
> Los cobros reales requieren **credenciales de producción**. Las de prueba solo sirven para probar y no procesan transacciones. Guarda tu Access Token en un lugar seguro y no lo compartas.

## Cómo conectar Mercado Pago

### Paso 1: abre Mercado Pago en Chateea

**1. Ve a Pagos → Integraciones**

Desde el menú lateral de tu cuenta.

**2. Busca Mercado Pago y haz clic en Conectar**

Se abre la pantalla con los campos de credenciales.

### Paso 2: obtén tus credenciales de producción

**1. Entra al área de desarrolladores de Mercado Pago**

Inicia sesión con la cuenta que recibirá los cobros y abre **Tus integraciones**.

**2. Abre o crea una aplicación**

Si no tienes una, créala: ponle un nombre, elige pagos en línea como tipo de integración, confirma los datos y activa las credenciales de producción.

**3. Copia las credenciales**

En **Credenciales de producción**, copia la **Public Key** y el **Access Token**. Si aún no están activas, completa los datos que pida Mercado Pago (rubro, sitio web).

### Paso 3: ingresa las credenciales en Chateea

**1. Pega la Public Key y el Access Token**

Cada uno en su campo.

**2. Elige el país de la cuenta**

Debe coincidir con el país donde está registrada tu cuenta de Mercado Pago.

**3. Genera o escribe el secreto del webhook**

Guárdalo: lo necesitarás idéntico en el paso siguiente.

**4. Guarda**

Haz clic en **Guardar** o **Conectar**. Tu cuenta queda vinculada.

### Paso 4: configura el webhook en Mercado Pago

El webhook permite que los eventos de pago vuelvan a Chateea y tus transacciones se actualicen.

**1. Abre Webhooks en tu aplicación**

En el [panel de desarrolladores de Mercado Pago](https://www.mercadopago.com.br/developers/en), abre la aplicación que usaste y entra a **Webhooks**.

**2. Haz clic en Configurar notificaciones**

Se abre el formulario de URLs.

**3. Pega la URL del webhook en modo producción**

Copia la URL exactamente como aparece en la pantalla de configuración de Mercado Pago dentro de Chateea. Si no la ves, pídela a soporte en **[help@chateea.com](mailto:help@chateea.com)**. Un solo carácter distinto impide que lleguen los eventos.

**4. Agrega el mismo secreto del webhook**

Debe ser idéntico al que guardaste en Chateea.

**5. Selecciona el evento Pagos y guarda**

Es el evento que necesita la integración.

### Paso 5: asigna Mercado Pago a tus canales

En Chateea, abre **Gestionar configuraciones de proveedor** de Mercado Pago:

* Cambia entre modo **en vivo** y **de prueba** según necesites.
* Activa Mercado Pago en los canales donde quieras cobrar con él.

## Limitaciones importantes

* **Un solo elemento de pago por página.** Mercado Pago no permite abrir dos pantallas de pago en la misma sesión. Por ejemplo, dos formularios de pedido de un paso con captura de tarjeta en la misma página de un embudo no cargarán.
* **Sin conversión de moneda.** Cobra en la moneda local de tu cuenta de Mercado Pago. Si tu cuenta es de Argentina, pon tus precios en pesos argentinos.
* **Montos mínimos y máximos.** Cada país y método de pago tiene sus límites; si un producto no los cumple, el pago puede fallar.

## Preguntas frecuentes

> **¿Hay montos mínimos o máximos en mi país?**
>
> Sí. Mercado Pago define límites por método de pago. Como referencia, en Argentina:
>
> | Método | Mínimo | Máximo |
> | - | - | - |
> | **Tarjetas de crédito y débito** (Visa, Mastercard, American Express, Naranja, Cabal, Sucrédito) | 100 pesos por pago único o por cuota | 15.000.000 pesos |
> | **Pago Fácil y Rapipago** | 100 pesos | 1.000.000 pesos |
>
> Estos montos pueden cambiar. Confírmalos siempre en la [ayuda oficial de Mercado Pago](https://www.mercadopago.com.ar/ayuda/monto-minimo-maximo-medios-de-pago_620) para tu país.

> **¿Qué pasa si creo un producto en dólares?**
>
> Mercado Pago no convierte la moneda en esta integración. Usa la misma moneda que tu cuenta local de Mercado Pago.

> **Puse dos elementos de pago en mi embudo y no funcionan**
>
> Por seguridad, Mercado Pago solo permite una pantalla de pago activa por sesión. Deja un único elemento de pago de Mercado Pago por página.

> **¿Qué pasa si mi cuenta no tiene el pago sin CVV?**
>
> Es muy recomendable activarlo. Sin él, las suscripciones y los cobros fuera de sesión (con tarjeta guardada, sin que el cliente esté presente) pueden no funcionar bien.

> **¿Qué es el pago sin CVV/CVC?**
>
> El CVV o CVC es el código de seguridad de 3 o 4 dígitos de la tarjeta. En los cobros con tarjeta guardada, pedirlo cada vez genera fricción y abandono. Con el pago sin CVV, la tarjeta queda guardada de forma segura y los cobros repetidos son más fluidos. Puede que tu cuenta ya lo tenga; confírmalo con el soporte de Mercado Pago y, si no, pide la activación.

> **¿Cómo genero el secreto del webhook?**
>
> Es una cadena aleatoria que se usa para firmar las notificaciones. Puede ser una contraseña que recuerdes, pero es más seguro usar un generador de secretos HMAC-SHA256. Lo importante es que sea exactamente igual en Chateea y en Mercado Pago.

> **[Configurar proveedores de pago por canal](https://help.chateea.com/docs/pagos/proveedores-pago-por-canal.md)**
>
> Define en qué canales aparece Mercado Pago.

> **[Cobro simplificado con enlaces de pago](https://help.chateea.com/docs/pagos/enlaces-de-pago.md)**
>
> Comparte un enlace y cobra con Mercado Pago.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.