# 💳 Pasarela de Pagos Todo en Uno para LATAM (Mercado Pago Developers API)

> **Resumen para No Técnicos**: Permite que tu Inteligencia Artificial o tu tienda online genere enlaces de pago (*Checkout Pro*) y cobre a tus clientes utilizando los métodos de pago más populares de cada país en Latinoamérica: transferencias bancarias directas (SPEI en México, PSE en Colombia, Pix en Brasil), tarjetas de crédito en cuotas y pagos en efectivo en tiendas de conveniencia (OXXO, Efecty, Pago Fácil).

| Metadato | Detalle |
|---|---|
| **Tipo** | API REST Oficial de Pagos y Webhooks |
| **Área Empresarial** | 03. Finanzas, Pagos y Cobranza |
| **Nivel de Dificultad** | 🟡 Media |
| **Modelo de Costo** | Sin costo mensual de mantenimiento. Comisión estándar por venta aprobada (aprox. 2.99% a 3.49% + IVA) |
| **Enlace Oficial** | [Mercado Pago Developers](https://www.mercadopago.com/developers) |

---

## 💡 ¿Para qué le sirve a tu empresa? (Valor Real)

En América Latina, millones de personas no tienen tarjeta de crédito internacional o desconfían de ingresar sus datos en páginas desconocidas. Sin embargo, todos tienen una cuenta bancaria local o efectivo.

Con la API de Mercado Pago:
- Cuando un cliente confirma un pedido por WhatsApp o correo, la IA le genera un enlace de cobro seguro con el monto exacto:
  > *"Aquí tienes tu enlace oficial de pago por $45.000 COP / $350 MXN. Puedes pagar con PSE, OXXO o tarjeta en cuotas: `https://mpago.la/abc123`"*
- Cuando el cliente paga, Mercado Pago le avisa a tu sistema por *Webhook* en 1 segundo para que despaches el producto de inmediato.

---

## 🎁 ¿Qué valor aporta frente a soluciones tradicionales?

- **Cobertura regional completa**: Opera de forma nativa en México, Colombia, Brasil, Chile, Argentina, Perú y Uruguay.
- **Cobro en Cuotas**: Permite que tus clientes paguen en hasta 12 o 24 mensualidades mientras tú recibes el dinero de inmediato.
- **Prevención de Fraude**: Motor antifraude integrado que bloquea transacciones sospechosas sin costo extra.

---

## 🔑 ¿Qué necesitas para activarlo?

1. Una cuenta de Mercado Pago (personal o empresarial con el RUT/RFC/NIT de tu empresa).
2. Ingresar a *Tus Integraciones* en [mercadopago.com/developers](https://www.mercadopago.com/developers).
3. Obtener tu `PUBLIC_KEY` y `ACCESS_TOKEN` (cuenta con credenciales de prueba *Sandbox* para hacer ensayos sin dinero real).

---

## ⚙️ Configuración Paso a Paso

Variables de entorno para tu backend, automatización o servidor MCP:

```env
# Variables de entorno (.env)
MERCADOPAGO_ACCESS_TOKEN=tu_access_token_mercadopago_aqui
MERCADOPAGO_PUBLIC_KEY=tu_public_key_mercadopago_aqui
MERCADOPAGO_COUNTRY=CO # CO (Colombia), MX (México), CL (Chile), AR (Argentina), PE (Perú)
```

---

## 🤖 Consultor Interactivo (Prompt Guiado para tu IA)

Copia y pega este prompt en tu chat con la IA:

```markdown
Actúa como mi Asistente de Finanzas y Cobranza Comercial.
Vamos a generar un enlace de cobro oficial a través de la API de Mercado Pago.

Por favor, pregúntame:
1. ¿Cuál es el nombre del cliente o empresa que va a pagar?
2. ¿Cuál es el concepto o descripción del producto/servicio (ej: Anticipo de 50% proyecto diseño web)?
3. ¿Cuál es el monto exacto y la moneda local (COP, MXN, CLP, PEN, ARS)?
4. ¿Deseas habilitar pagos en cuotas y efectivo o solo transferencias y tarjetas?

Con tus datos, estructuraré la preferencia de pago en Mercado Pago, validaré que no haya errores en los montos y generaré el enlace listo para enviar por WhatsApp o correo con un mensaje de cobro formal.
```

---

## 🌎 Caso de Uso Real en América Latina

**Empresa**: "Óptica Santa Lucía" (Lentes y monturas graduadas en Monterrey, México).
- **Problema**: Los clientes dejaban sus pedidos en pausa porque querían pagar el 50% en OXXO y el 50% con tarjeta a meses sin intereses.
- **Resultado con la API**: La IA genera el enlace personalizado para cada cliente con ambas opciones habilitadas. El abandono de carritos de compra cayó del 48% al 14%.

---

## 🛡️ Consideraciones de Seguridad y Buenas Prácticas

- **Usa el Modo Prueba (Sandbox)**: Antes de cobrar a clientes reales, realiza pruebas con tarjetas ficticias que ofrece la documentación oficial de Mercado Pago.
- **Verificación de Notificaciones**: Configura siempre la verificación de firma en los Webhooks para confirmar que la notificación de pago proviene genuinamente de Mercado Pago y no de un tercero malicioso.