Comorando Empezar gratis →

⚠️ Error conocido de Mercado Pago

Error 503 en Mercado Pago: Webhooks y Notificaciones

Entiende el error 503 en Mercado Pago, causas técnicas y cómo solucionarlo para evitar interrupciones en tus pagos.

¿Por qué ocurre este error?

El error 503 (Service Unavailable) en Mercado Pago indica que el servidor no puede procesar la solicitud. Esto suele ocurrir debido a sobrecargas temporales en el servidor de Mercado Pago o problemas de conectividad entre tu aplicación y sus sistemas. El código HTTP 503 sugiere un problema temporal del lado del servidor, y a menudo requiere reintentos (retry) para superar la interrupción.

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