> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clausum.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ingestión de eventos

> Camino inbound por defecto — envía eventos de cualquier procesador o ledger con claves clm_wh_*

**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](/es/guides/stripe-webhooks) (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](/es/guides/realtime-assessment) (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](/es/guides/stripe-webhooks) 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

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

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

## 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

```json theme={null}
{
  "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](/es/guides/receiving-webhooks) — eventos **desde** Clausum hacia ti
* [Webhooks Stripe](/es/guides/stripe-webhooks) — adaptador nativo Stripe opcional
* [Arquitectura](/es/concepts/architecture) — visión general del flujo de datos


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.