Comorando Empezar gratis →

⚠️ Error conocido de Mercado Pago

Error 'Notificación Timeout' en Mercado Pago

Entiende y soluciona el error de timeout en notificaciones de Mercado Pago, afectando Webhooks e IPN.

¿Por qué ocurre este error?

El error 'Notificación Timeout' en Mercado Pago se produce cuando el servidor no recibe la notificación dentro del tiempo límite establecido (normalmente 60 segundos). Esto puede deberse a problemas de red, latencia del servidor o un alto volumen de transacciones. A menudo se manifiesta con códigos HTTP 504 Gateway Timeout o 503 Service Unavailable.

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);
});