Comorando Empezar gratis →

⚠️ Error conocido de Mercado Pago

Error Postback Timeout Mercado Pago

¿Tu negocio no recibe notificaciones de Mercado Pago? Descubre las causas y soluciones a este error común en webhooks.

¿Por qué ocurre este error?

El error ‘Postback timeout’ en Mercado Pago se produce cuando el servidor de destino no recibe la notificación de pago dentro del tiempo límite establecido (normalmente 60 segundos). Esto puede ser causado por problemas de red, sobrecarga del servidor o configuraciones incorrectas en el webhook. El código HTTP 504 (Gateway Timeout) es común en este escenario, indicando que el servidor de Mercado Pago no pudo obtener respuesta del destino. Mercado Pago intenta reintentar la notificación, pero si el problema persiste, el error se manifiesta.

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