Comorando Empezar gratis →

⚠️ Error conocido de Mercado Pago

Callback Timeout Mercado Pago: Solución y Diagnóstico

El error 'Callback Timeout' en Mercado Pago indica que no se recibió la notificación a tiempo, afectando transacciones. Investiga la causa y configura correctamente los webhooks.

¿Por qué ocurre este error?

El error 'Callback Timeout' en Mercado Pago surge generalmente por problemas de conectividad entre tu servidor y los servidores de Mercado Pago. Esto puede manifestarse como un código HTTP 504 (Gateway Timeout) si la solicitud tarda en ser procesada. Además, Mercado Pago puede intentar enviar múltiples notificaciones (retries) si la primera falla, pero si el tiempo de espera configurado es demasiado corto, se produce el timeout.

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