Comorando Empezar gratis →

⚠️ Error conocido de Mercado Pago

Webhook Mercado Pago: Timeout - Solución

Errores de Webhooks de Mercado Pago: Entiende y corrige el timeout para notificaciones y pagos sin interrupciones.

¿Por qué ocurre este error?

El timeout en un webhook de Mercado Pago generalmente se debe a problemas de conectividad o latencia en la red entre tu servidor y los servidores de Mercado Pago. Esto puede resultar en que la solicitud del webhook no se complete dentro del tiempo límite, generando un código de error HTTP 504 (Gateway Timeout). Además, un alto volumen de solicitudes o problemas de rendimiento en tu servidor pueden agotar los recursos y provocar el fallo del webhook antes de que Mercado Pago pueda procesarlo.

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