Eventos y notificaciones

Guia rapida de webhooks

Los webhooks permiten recibir eventos de links de pago sin hacer polling.

Flujo recomendado

Checklist

  • Registrar endpoint HTTPS en tu aplicacion.
  • Validar el esquema del payload recibido.
  • Responder `2xx` rapidamente.
  • Procesar de forma asincrona para evitar timeouts.

Buenas practicas

  • Idempotencia por `payment_id`.
  • Reintentos con backoff exponencial.
  • Registro de payload y respuesta para auditoria.
  • Alertas para tasas de fallo altas.

Payload de ejemplo

payment_link.paid
{
  "source": "mopago_developer_platform",
  "event": "payment_link.paid",
  "payment_id": "order_1024",
  "developer_code": "mpp_dev_00000001",
  "payload": {
    "Payload": {
      "MensajePago": {
        "IdentificadorOrdenVenta": "order_1024",
        "EstadoTransaccion": "APROBADA"
      }
    }
  }
}