Comorando Empezar gratis →

⚠️ Error conocido de Mercado Pago

Webhook Mercado Pago: Retraso y Soluciones

Entiende el retraso en las notificaciones de Mercado Pago y cómo solucionarlo para evitar problemas en tus procesos.

¿Por qué ocurre este error?

El retraso en los webhooks de Mercado Pago suele deberse a problemas de conectividad o latencia en la red entre tu servidor y los servidores de Mercado Pago. Esto puede resultar en HTTP codes como 504 Gateway Timeout o 502 Bad Gateway, provocando que el webhook no se procese inmediatamente. Mercado Pago implementa mecanismos de retry, pero la configuración incorrecta o la sobrecarga en tu servidor pueden agotar estos intentos.

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