Event ingestion

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-hoc provider events	`POST /api/webhooks/ingest` with `clm_wh_*` — chargebacks, settlements, async updates
Stripe native	`POST /api/webhooks/stripe` — Stripe adapter (signature verified)

Assess does not replace ingest for full transaction lifecycle; many merchants use both.

Create an ingest key

Dashboard → Conexiones → Entrada (webhooks)
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 Conexiones if compromised
Do not expose clm_wh_* in browser code — server-side only

Monitor

Conexiones → Monitor shows recent partner API activity. For outbound deliveries from Clausum to your servers, use the delivery log on the Entrada (webhooks) tab.

Receiving webhooks — events from Clausum to you
Stripe webhooks — first-class Stripe inbound
Architecture — data flow overview

Reporting fraudReport confirmed fraud and let Clausum block, open a case, and notify the chain.

Get started

Integrate by client type

Capabilities — 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