Comorando Empezar gratis →

⚠️ Error conocido de Mercado Pago

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

Entiende el error 503 en Push de Mercado Pago y cómo solucionarlo, incluyendo webhook y notificaciones.

¿Por qué ocurre este error?

El error 503 Push indica que Mercado Pago no pudo enviar la notificación debido a un problema temporal en su servidor. Esto puede ser causado por un timeout HTTP (504 Gateway Timeout) al intentar establecer la conexión, o por la sobrecarga del servidor de Mercado Pago. La solución más común es implementar una lógica de reintento con backoff exponencial para manejar estos fallos transitorios.

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