Comorando Empezar gratis →

⚠️ Error conocido de Mercado Pago

Error 503 Postback Mercado Pago: Solución Técnica

Entiende y resuelve el error 503 en postbacks de Mercado Pago, un problema común en webhooks y notificaciones.

¿Por qué ocurre este error?

El error 503 Postback de Mercado Pago indica que el servidor al que estás enviando el postback no está disponible en ese momento. Esto puede ser debido a una sobrecarga temporal del servidor o a un problema de conectividad. Normalmente, Mercado Pago intenta reintentar el envío, pero si el problema persiste, se devuelve el código 503.

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