Comorando Empezar gratis →

⚠️ Error conocido de Mercado Pago

Error 401 Mercado Pago: Webhooks y Notificaciones

Entiende el error 401 en Mercado Pago, causas y cómo solucionarlo para asegurar la correcta recepción de tus notificaciones.

¿Por qué ocurre este error?

El error 401 (Unauthorized) indica que la solicitud enviada por Mercado Pago no está autenticada correctamente. Esto suele ocurrir debido a una clave API incorrecta o una falta de configuración adecuada de las credenciales de acceso. El servidor de Mercado Pago requiere una autenticación válida para procesar las notificaciones, y la ausencia de esta puede resultar en este error HTTP. La configuración incorrecta de los headers de autorización es la causa más frecuente, requiriendo un reintento con credenciales válidas.

Código de ejemplo

import crypto from 'node:crypto';
import express from 'express';
const app = express();

app.post('/webhook/mercadopago', express.json(), (req, res) => {
  const sig = req.headers['x-signature'] || '';
  const ts = sig.match(/ts=(\d+)/)?.[1];
  const v1 = sig.match(/v1=([a-f0-9]+)/)?.[1];
  const reqId = req.headers['x-request-id'];
  const data = `id:${req.body.data.id};request-id:${reqId};ts:${ts};`;
  const expected = crypto
    .createHmac('sha256', process.env.MP_WEBHOOK_SECRET)
    .update(data)
    .digest('hex');

  if (expected !== v1) return res.sendStatus(401);
  // Idempotencia: deduplicar por (data.id, action)
  res.sendStatus(200);
});