Comorando Empezar gratis →

⚠️ Error conocido de Mercado Pago

IPN vs Webhooks: Mercado Pago - Guía Técnica

Entiende la diferencia entre IPN y webhooks de Mercado Pago para evitar errores y asegurar notificaciones correctas.

¿Por qué ocurre este error?

El error surge porque IPN (Instant Payment Notification) es un protocolo HTTP POST legado, mientras que los webhooks son una comunicación bidireccional más moderna y eficiente. Si hay fallos en la conexión o timeouts, Mercado Pago puede devolver códigos HTTP 504 (Gateway Timeout) o 502 (Bad Gateway), provocando que la notificación no se procese correctamente.

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