Cómo configurar MercadoPago en tu tienda Jefnix

MercadoPago domina el mercado de pagos digitales en Argentina, Colombia, México, Chile, Perú y Brasil. Con más de 40 millones de usuarios activos en la región, aceptar MercadoPago en tu tienda no es un extra — es prácticamente un requisito si quieres que los clientes en LATAM puedan pagarte sin fricción.

La buena noticia: integrarlo con tu tienda Jefnix es más simple de lo que parece, y una vez configurado, el flujo completo — cobro, verificación, asignación de cuenta y envío de credenciales — funciona de manera totalmente automática.

---

Cómo funciona la integración

El flujo completo una vez configurado:

1. Cliente elige plan en tu tienda
2. Hace clic en "Pagar con MercadoPago"
3. Completa el pago en la ventana de MP (tarjeta, billetera, PSE, etc.)
4. MP notifica a tu servidor vía webhook que el pago fue aprobado
5. Tu servidor llama a POST /payments/confirm en Jefnix
6. Jefnix asigna la cuenta y envía credenciales al cliente por email
7. El cliente es redirigido a una página de confirmación

Pasos 4–6 son completamente automáticos. El cliente nunca sabe que Jefnix existe — solo recibe su acceso.

---

Requisitos previos

Requisito	Cómo obtenerlo
Cuenta de MercadoPago vendedor	mercadopago.com → Registrarse
Access Token de MP (producción)	Panel MP → Tus integraciones → Credenciales
API key de Jefnix	Dashboard Jefnix → Configuración → API Keys
Servidor web propio (Node.js/Next.js)	Railway, Render, Vercel, VPS
URL pública con HTTPS	Necesario para webhooks de MP

Nota sobre testing: MercadoPago tiene un sandbox completo. Trabaja siempre primero en sandbox con credenciales de prueba antes de activar producción.

---

Paso 1 — Obtén tus credenciales de MercadoPago

1. Entra a mercadopago.com/developers
2. Ve a Tus integraciones → Credenciales
3. Copia el Access Token (empieza por APP_USR-... en producción, TEST-... en sandbox)

MP_ACCESS_TOKEN=APP_USR-1234567890123456-031215-xxxxxxxxxxxxx
JEFNIX_API_KEY=jxk_live_XXXXXXXXXXXXXXXX
JEFNIX_API_URL=https://jefnix.com/api/v1

---

Paso 2 — Instalar el SDK

npm install mercadopago

---

Paso 3 — Crear la preferencia de pago

Cuando el cliente hace clic en "Comprar", tu servidor crea una preferencia de pago en MP:

import { MercadoPagoConfig, Preference } from 'mercadopago';

const client = new MercadoPagoConfig({ accessToken: process.env.MP_ACCESS_TOKEN });

const preference = new Preference(client);
const result = await preference.create({
  body: {
    items: [{ id: planId, title: planNombre, quantity: 1, unit_price: precio, currency_id: moneda }],
    payer: { email: clientEmail },
    back_urls: {
      success: `${BASE_URL}/pago/exitoso`,
      failure: `${BASE_URL}/pago/fallido`,
    },
    auto_return: 'approved',
    notification_url: `${BASE_URL}/api/webhooks/mercadopago`,
    metadata: { client_email: clientEmail, plan_id: planId }
  }
});
// Redirige al cliente a result.init_point

---

Paso 4 — Configurar el webhook

Este es el paso más crítico. Cuando MP procesa un pago, envía una notificación a tu URL:

export default async function handler(req, res) {
  if (req.method === 'GET') return res.status(200).end();
  const { type, data } = req.body;
  if (type !== 'payment') return res.status(200).end();

  const payment = new Payment(client);
  const pagoDetalle = await payment.get({ id: data.id });
  if (pagoDetalle.status !== 'approved') return res.status(200).end();

  await fetch(`${process.env.JEFNIX_API_URL}/payments/confirm`, {
    method: 'POST',
    headers: { 'x-api-key': process.env.JEFNIX_API_KEY, 'Content-Type': 'application/json' },
    body: JSON.stringify({
      client_email: pagoDetalle.metadata.client_email,
      plan_id: pagoDetalle.metadata.plan_id,
      amount: pagoDetalle.transaction_amount,
      note: `MP Payment ID: ${pagoDetalle.id}`
    })
  });

  res.status(200).end(); // Siempre 200 para evitar reintentos
}

---

Paso 5 — Registrar el webhook en MercadoPago

1. Entra al panel de desarrolladores de MP
2. Ve a Tus integraciones → Webhooks
3. Agrega tu URL: https://tudominio.com/api/webhooks/mercadopago
4. Selecciona el evento: payment
5. Guarda

---

Prueba con sandbox

MercadoPago tiene tarjetas de prueba para cada país:

País	Tarjeta de prueba	CVV	Fecha
Colombia	4013 5406 8274 6260	123	11/25
Argentina	4509 9535 6623 3704	123	11/25
México	4075 5957 1648 3764	123	11/25
Chile	4168 8188 4444 7115	123	11/25

---

Resumen del flujo completo

Paso	Tiempo	Quién lo hace
Elige plan y hace clic en "Pagar"	Inmediato	Cliente
Completa pago en MercadoPago	1–2 minutos	Cliente + MP
Webhook notifica tu servidor	< 5 segundos	MP → Tu servidor
Tu servidor confirma en Jefnix	< 1 segundo	Tu servidor → Jefnix
Jefnix asigna cuenta y envía email	< 30 segundos	Jefnix
Cliente recibe credenciales en email	Inmediato	Cliente

Tiempo total desde pago hasta credenciales: menos de 2 minutos, sin intervención manual.

---

Accede al dashboard y obtén tu API key →

¿Problemas con la integración? Escríbenos a soporte@jefnix.com con tu error y te ayudamos a resolverlo.