Comorando Empezar gratis →

⚠️ Error conocido de Mercado Pago

Error 503 - Mercado Pago: Webhooks Fallidos

Entiende el error 503 en Mercado Pago, causas y soluciones para tus webhooks e IPN. ¡Resuelve problemas de notificación!

¿Por qué ocurre este error?

El error 503 (Service Unavailable) indica que el servidor de Mercado Pago no pudo procesar la solicitud del webhook o IPN. Esto suele ocurrir por sobrecarga temporal del servidor, problemas de conectividad o un tiempo de espera agotado durante la comunicación. El servidor devuelve un código HTTP 503, solicitando un reintento.

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