Event ingestion

Generic ingest is the default inbound path in Connections → Inbound: one webhook URL + clm_wh_*, processor-agnostic. Optional processor guides (Stripe, Mercado Pago, …) are secondary helpers — not a logo catalog. Ingest lets you push events from your PSP, acquirer, or middleware into Clausum for enrichment, audit, and optional assess triggers — complementary to real-time assess (which you call at checkout).

When to use ingest vs assess

Pattern	Use
Assess at checkout	`POST /api/v1/assess` with `clm_sk_*` — decision before capture
Post-payment events (default)	`POST /api/webhooks/ingest` with `clm_wh_*` — any PSP, chargebacks, settlements, async updates
Optional native adapters	e.g. `POST /api/webhooks/stripe` — Stripe guide when you want provider-specific signature handling

Assess does not replace ingest for full transaction lifecycle; many merchants use both. Banks/PSPs use the same generic ingest — no payment-brand grid.

Create an ingest key

Dashboard → Connections → Inbound (webhooks) — hero is generic inbound webhook
Create Webhook ingest key → prefix clm_wh_*
Store the secret (shown once)

Ingest keys (clm_wh_*) are not partner secret keys (clm_sk_*). Using the wrong key returns 401.

Ingest endpoint

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

Example payload

{
  "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 normalizes known fields and attaches the event to your organization scope.

Security

HTTPS only in production
Rotate ingest keys from Connections if compromised
Do not expose clm_wh_* in browser code — server-side only

Monitor

Connections → Monitor shows recent partner API activity. For outbound deliveries from Clausum to your servers, use the delivery log on the same Monitor tab.

Receiving webhooks — events from Clausum to you
Stripe webhooks — optional native Stripe adapter
Architecture — data flow overview

Get started

Integrate by client type

Solutions & prevention

Capabilities — events & ops

Dashboard

Core concepts

Reference

Event ingestion

When to use ingest vs assess

Create an ingest key

Ingest endpoint

Example payload

Security

Monitor

​When to use ingest vs assess

​Create an ingest key

​Ingest endpoint

​Example payload

​Security

​Monitor

​Related

When to use ingest vs assess

Create an ingest key

Ingest endpoint

Example payload

Security

Monitor

Related