Comorando Empezar gratis →

⚠️ Error conocido de Mercado Pago

Webhook Mercado Pago 503: Solución Rápida

Entiende el error 503 en webhooks de Mercado Pago y cómo solucionarlo para evitar interrupciones en tus procesos.

¿Por qué ocurre este error?

El código 503 (Service Unavailable) generalmente indica que el servidor de Mercado Pago está temporalmente sobrecargado o experimentando problemas internos. Esto puede ser causado por un alto volumen de solicitudes o un mantenimiento programado, resultando en un fallo en la entrega del webhook. Mercado Pago implementa mecanismos de retry, pero a veces estos fallan, requiriendo una verificación manual.

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