Comorando Empezar gratis →

⚠️ Error conocido de Mercado Pago

Error 'Pago Fallido' Mercado Pago: Webhooks y IPN

Soluciona problemas de notificaciones de pago fallidas en tu web con este guía técnica sobre webhooks, IPN y Mercado Pago.

¿Por qué ocurre este error?

El error 'Pago Fallido' en Mercado Pago suele deberse a problemas de conectividad o a retrasos en la recepción de las notificaciones. Esto puede resultar en códigos HTTP como 504 Gateway Timeout o 408 Request Timeout, impidiendo que tu aplicación reciba la información del pago. Además, la configuración incorrecta de la IPN (Instant Payment Notification) o la falta de sincronización entre tu sistema y el servidor de Mercado Pago pueden generar este fallo.

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