Comorando Empezar gratis →

⚠️ Error conocido de Mercado Pago

Error 'Pago Notificación Retry Fallida' Mercado Pago

Entiende y soluciona el error de retries en notificaciones de pago de Mercado Pago, impactando la sincronización de transacciones.

¿Por qué ocurre este error?

Este error se origina en fallos temporales en la comunicación entre tu aplicación y los servidores de Mercado Pago. Generalmente, se manifiesta como un código HTTP 504 (Gateway Timeout) o 502 (Bad Gateway) durante el intento de recepción del webhook. Mercado Pago, para asegurar la entrega de la notificación, implementa un mecanismo de retry que puede generar múltiples intentos fallidos si la comunicación es intermitente.

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