Comorando Empezar gratis →

⚠️ Error conocido de Mercado Pago

Error 'Evento Retraso' en Mercado Pago: Webhooks y Notificaciones

Entiende las causas del error 'Evento Retraso' en Mercado Pago, relacionado con webhooks y notificaciones, y aprende a solucionarlo rápidamente.

¿Por qué ocurre este error?

El error 'Evento Retraso' en Mercado Pago surge principalmente por retrasos en la recepción y procesamiento de las notificaciones enviadas por Mercado Pago. Esto puede estar relacionado con problemas de conectividad entre tu servidor y los servidores de Mercado Pago, resultando en códigos HTTP 504 (Gateway Timeout) o 502 (Bad Gateway). Mercado Pago, al intentar retransmitir la notificación, puede generar un retraso adicional, manifestándose como este error.

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