El webhook de Mercado Pago o Stripe que no llegó

El cliente pagó, vio «pago aprobado» y su pedido sigue «pendiente» en tu sistema. Casi siempre es un webhook que no llegó o que llegó y falló. Aquí, cómo saber cuál de los dos fue, las causas más comunes, el código para contestarlo bien y cómo enterarte antes de que el cliente te escriba.

1. Cómo se ve

El cobro pasa en Mercado Pago o en Stripe. Tu sistema se entera por un webhook: una petición que ellos le hacen a tu servidor cuando el pago cambia. Si esa petición no llega o tu servidor contesta con error, pasa esto:

• En el panel de Mercado Pago o de Stripe el pago está aprobado.
• En tu sistema el pedido sigue pendiente: nadie lo surte, no sale el correo de confirmación.
• Nada truena. No hay error en pantalla ni en tus logs, a menos que tu código haya fallado al recibirlo.

Te enteras cuando el cliente escribe «ya pagué, ¿dónde está mi pedido?». Lo que sigue es para enterarte antes.

2. ¿Se envió? Revísalo en el panel

Lo primero es saber si el proveedor lo mandó y qué le contestó tu servidor. Los dos guardan el historial.

Mercado Pago

• Entra a Tus integraciones, elige tu aplicación y abre Webhooks.
• En el panel de notificaciones ves cada envío con su resultado (exitoso o fallido), la acción, el evento y la hora. Puedes filtrar por estado y por fecha, y abrir cada uno para ver el JSON que se mandó.
• Mercado Pago espera un 200 o 201 durante 22 segundos. Si no lo recibe, reintenta cada 15 minutos; después del tercer intento los espacia, pero sigue.

Stripe

• En Workbench, abre la pestaña Webhooks, elige tu endpoint y ve a Eventos. Cada entrega dice qué código regresó tu servidor.
• En modo en vivo, Stripe reintenta hasta por tres días, cada vez más espaciado. Ahí mismo ves cuándo es el próximo intento.
• Puedes reenviar un evento con el botón «Reenviar» hasta 15 días después de creado, o con la CLI hasta 30 días: stripe events resend <event_id> --webhook-endpoint=<endpoint_id>.

3. Las causas más comunes

Lo que diga el panel te lleva casi directo a la causa.

4. Contestarlo bien

La regla es la misma en los dos: verifica la firma, contesta rápido y procesa después. Y anota que llegó, para poder buscarlo.

Stripe, en Express

// el cuerpo sin tocar SOLO en esta ruta; express.json() va después
app.post('/webhooks/stripe', express.raw({ type: 'application/json' }), (req, res) => {
  let evento;
  try {
    evento = stripe.webhooks.constructEvent(
      req.body, req.headers['stripe-signature'], process.env.STRIPE_WEBHOOK_SECRET);
  } catch (err) {
    console.error('webhook stripe: firma inválida', err.message);
    return res.sendStatus(400);
  }
  res.sendStatus(200);   // primero contestar
  procesar(evento).catch((err) => console.error('webhook stripe', evento.id, err));
});

Mercado Pago, en Express

app.post('/webhooks/mercadopago', express.json(), (req, res) => {
  // valida x-signature con la clave secreta de tu aplicación (los SDK oficiales lo hacen)
  if (!firmaValida(req)) return res.sendStatus(401);
  res.sendStatus(200);   // antes de 22 segundos
  if (req.body.type !== 'payment') return;
  revisarPago(req.body.data.id).catch((err) => console.error('webhook mp', req.body.data.id, err));
});

async function revisarPago(id) {
  const r = await fetch(`https://api.mercadopago.com/v1/payments/${id}`, {
    headers: { Authorization: `Bearer ${process.env.MP_ACCESS_TOKEN}` },
  });
  const pago = await r.json();
  // pago.status: approved, pending, rejected…  pago.external_reference: tu pedido
  if (pago.status === 'approved') await marcarPagado(pago.external_reference);
}

Contestar antes de procesar tiene un costo: si procesar falla, el proveedor ya no reintenta, porque le dijiste que sí. Por eso el siguiente paso.

5. No dependas solo del webhook

El webhook es el camino rápido, no el único. Dos respaldos baratos:

• Cuando el cliente regresa a tu página de «gracias» (back_urls en Mercado Pago, success_url en Stripe), consulta tú el pago. Si ya está aprobado, marca el pedido: no esperes al webhook.
• Una tarea cada 15 minutos que busque pedidos «pendientes» de más de media hora y pregunte su estado. En Mercado Pago, por external_reference; en Stripe, la Checkout Session o el PaymentIntent.

6. Que te avise solo

Todo lo anterior arregla el problema cuando ya sabes que existe. Falta enterarte el mismo día, no cuando escribe el cliente. La idea: anotar dos momentos y que alguien vigile que el segundo llegue.

• Abre cuando el cliente regresa con el pago aprobado: ya sabes que pagó.
• Cierra cuando tu webhook lo procesó.
• Si pasan 30 minutos sin cierre, algo se perdió en medio.

Con Estiaje son dos líneas en tu código:

// en tu página de «gracias», cuando el pago viene aprobado
estiaje.event('pago.aprobado_por_cliente', { pedido_id, monto });

// en tu webhook, cuando ya marcaste el pedido
estiaje.outcome('pago.confirmado', { pedido_id });

Y en el panel declaras qué esperas, sin tocar más código:

{
  "name":       "Pago aprobado → webhook procesado",
  "when":       "pago.aprobado_por_cliente",
  "expects":    "pago.confirmado",
  "match_by":   "attrs.pedido_id",
  "window_min": 30,
  "valor":      { "tipo": "atributo", "atributo": "monto" }
}

Si un pedido se queda sin cierre, te llega al teléfono algo como «$1,280 en riesgo: Pago aprobado → webhook procesado», con el pedido que se quedó a medias y, si le pones la liga a tu sistema, el botón para abrirlo. Si tu webhook truena, el error llega agrupado, con su stack y el pedido que dejó a medias.

Preguntas frecuentes

Fuentes: la documentación de webhooks de Mercado Pago (mercadopago.com.mx/developers) y de Stripe (docs.stripe.com/webhooks), revisadas el 12 de octubre de 2026.