Comorando Empezar gratis →

⚠️ Error conocido de Mercado Pago

Webhook Mercado Pago: Error 'Retry Fallido'

Entiende y soluciona el error 'Webhook Retry Fallido' en Mercado Pago, causas y soluciones para notificaciones fallidas.

¿Por qué ocurre este error?

El error 'Webhook Retry Fallido' en Mercado Pago suele ser causado por problemas de conectividad temporal del servidor receptor, resultando en errores HTTP 504 (Gateway Timeout) o 502 (Bad Gateway) al intentar comunicarse con los servidores de Mercado Pago. Mercado Pago, por su lado, implementa mecanismos de retry para estas fallas, pero si la causa persiste, el webhook puede marcarse como 'Retry Fallido'.

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