Ingestión de eventos

El ingest genérico es el camino inbound por defecto en Conexiones → Entrada: una URL de webhook + clm_wh_*, agnóstico al procesador. Las guías por procesador (Stripe, Mercado Pago, …) son ayudas secundarias — no un catálogo de logos. Ingest te permite empujar eventos de tu PSP, adquirente o middleware a Clausum para enriquecimiento, auditoría y triggers opcionales de assess — complementario a assess en tiempo real (que llamas en checkout).

Cuándo usar ingest vs assess

Patrón	Uso
Assess en checkout	`POST /api/v1/assess` con `clm_sk_*` — decisión antes del capture
Eventos post-pago (por defecto)	`POST /api/webhooks/ingest` con `clm_wh_*` — cualquier PSP, chargebacks, liquidaciones, actualizaciones async
Adaptadores nativos opcionales	p. ej. `POST /api/webhooks/stripe` — Guía Stripe cuando quieres manejo de firma específico del proveedor

Assess no reemplaza ingest para el ciclo de vida completo; muchos comercios usan ambos. Bancos/PSP usan el mismo ingest genérico — sin grid de marcas de pago.

Crear una clave de ingestión

Panel → Conexiones → Entrada (webhooks) — el hero es el webhook genérico de entrada
Crea Clave de ingestión webhook → prefijo clm_wh_*
Guarda el secreto (mostrado una vez)

Las claves de ingestión (clm_wh_*) no son claves secretas partner (clm_sk_*). Usar la clave incorrecta devuelve 401.

Endpoint de ingestión

POST https://dashboard.clausum.ai/api/webhooks/ingest
Authorization: Bearer clm_wh_YOUR_KEY
Content-Type: application/json

Payload de ejemplo

{
  "event_type": "payment.captured",
  "external_id": "pi_3Nx...",
  "amount": 4500,
  "currency": "USD",
  "customer_email": "buyer@example.com",
  "occurred_at": "2026-06-28T12:00:00Z",
  "metadata": {
    "provider": "custom_psp"
  }
}

Clausum normaliza campos conocidos y adjunta el evento al scope de tu organización.

Seguridad

Solo HTTPS en producción
Rota claves de ingestión desde Conexiones si se comprometen
No expongas clm_wh_* en código de navegador — solo servidor

Monitor

Conexiones → Monitor muestra actividad reciente de Partner API. Para entregas salientes desde Clausum hacia tus servidores, usa el log de entregas en la misma pestaña Monitor.

Relacionado

Recibir webhooks — eventos desde Clausum hacia ti
Webhooks Stripe — adaptador nativo Stripe opcional
Arquitectura — visión general del flujo de datos

Primeros pasos

Integración por tipo de cliente

Soluciones y prevención

Capacidades — eventos y operaciones

Panel de control

Conceptos clave

Referencia

Ingestión de eventos

Cuándo usar ingest vs assess

Crear una clave de ingestión

Endpoint de ingestión

Payload de ejemplo

Seguridad

Monitor

Relacionado

​Cuándo usar ingest vs assess

​Crear una clave de ingestión

​Endpoint de ingestión

​Payload de ejemplo

​Seguridad

​Monitor

​Relacionado

Cuándo usar ingest vs assess

Crear una clave de ingestión

Endpoint de ingestión

Payload de ejemplo

Seguridad

Monitor

Relacionado