Webhook events

Clausum sends outbound webhooks to HTTPS endpoints you configure under Connections → Get started → Outbound webhooks (sandbox and production are separate). Each delivery is an HTTP POST with JSON body and HMAC signature headers. See Receiving webhooks for verification and handling.

Event catalog (16 events)

Event	When it fires
`transaction.created`	After `POST /api/v1/assess` (or payout assess) returns `approve`, `review`, or `challenge`
`transaction.blocked`	After assess returns `decline`
`assess.outcome_applied`	After `POST /api/v1/assess/outcome` or automated dispute closure (chargeback won/lost, etc.)
`case.recommended`	After live assess when risk tier warrants a case file (includes `wizard_url`, `tier`, `risk_score`)
`transaction.succeeded`	Inbound payment provider confirms success (via generic ingest or optional native adapter)
`transaction.failed`	Inbound provider reports payment failure
`fraud.detected`	Fraud reported via `POST /api/v1/report-fraud` or equivalent flow
`fraud.confirmed`	Case marked as confirmed fraud in the dashboard
`case.created`	Case opened automatically (e.g. dispute / early-fraud warning from ingest)
`case.updated`	Case status or fields changed
`case.dispatched`	Case sent to participants (email + forensic annex)
`case.authority_response`	Institutional authority updated case follow-up
`case.dispatch_acknowledged`	Participant acknowledged dispatch receipt
`dispute.created`	Chargeback / dispute opened
`dispute.updated`	Dispute updated while open
`dispute.resolved`	Dispute closed (won, lost, or withdrawn)

Subscribe only to events your backend will handle — the dashboard checkbox list matches this catalog exactly.

Payload examples

`transaction.created` (assess approve / review / challenge)

{
  "event": "transaction.created",
  "timestamp": "2026-07-05T18:30:00.000Z",
  "data": {
    "session_id": "ps_1716998400000_abc",
    "decision": "approve",
    "risk_score": 12,
    "order_id": "ORD-2024-991",
    "payment_id": "pi_3Nxyz",
    "amount": 4500,
    "currency": "USD",
    "email": "buyer@example.com",
    "flow": "payin",
    "assess_response": {
      "decision": "approve",
      "session_id": "ps_1716998400000_abc",
      "risk_score": 12,
      "signals": []
    }
  }
}

`case.recommended`

{
  "event": "case.recommended",
  "timestamp": "2026-09-12T01:00:00.000Z",
  "data": {
    "session_id": "ps_1716998400000_abc",
    "payment_session_id": "uuid",
    "decision": "approve",
    "tier": "critical",
    "action": "auto_send",
    "risk_score": 82,
    "approved_but_suspicious": true,
    "suggested_submit_mode": "auto_send",
    "wizard_url": "https://dashboard.clausum.ai/dashboard/cases/nuevo?from=transaction&…",
    "case_id": null,
    "auto_created": false
  }
}

`assess.outcome_applied`

{
  "event": "assess.outcome_applied",
  "timestamp": "2026-08-02T12:00:00.000Z",
  "data": {
    "session_id": "ps_1716998400000_abc",
    "outcome": "chargeback_lost",
    "outcome_id": "uuid",
    "feedback_applied": true,
    "feedback": { "blocklist": true },
    "provider": "stripe",
    "provider_dispute_id": "dp_1Nxyz",
    "reason": "Issuer chargeback 10.4"
  }
}

`transaction.blocked` (assess decline)

{
  "event": "transaction.blocked",
  "timestamp": "2026-07-05T18:30:00.000Z",
  "data": {
    "session_id": "ps_1716998400000_abc",
    "order_id": "ORD-2024-991",
    "payment_id": "pi_3Nxyz",
    "decision": "decline",
    "risk_score": 100,
    "blocked_by": "Email blocked: reported as chargeback",
    "assess_response": {
      "decision": "decline",
      "session_id": "ps_1716998400000_abc",
      "order_id": "ORD-2024-991"
    }
  }
}

`fraud.detected` (report-fraud)

{
  "event": "fraud.detected",
  "timestamp": "2026-07-05T18:30:00.000Z",
  "data": {
    "case_id": "b1f2...",
    "reference_number": "CLM-LX9A2B",
    "transaction_id": "uuid-clausum-tx",
    "payment_id": "pi_3Nxyz",
    "reason": "chargeback",
    "amount": 89900,
    "currency": "USD",
    "email": "fraudster@example.com",
    "blocklist_entries": 2
  }
}

transaction_id is the Clausum internal UUID. Merchant references use order_id / payment_id from assess.

Signature headers

Every delivery includes:

Header	Description
`X-Clausum-Signature`	`t=<unix>,v1=<hmac_sha256_hex>`
`X-Clausum-Event`	Event type
`X-Clausum-Timestamp`	ISO 8601 delivery time

Delivery & retries

Time out your handler quickly; respond 2xx and process asynchronously.
Failed deliveries are retried via background jobs (typically every few minutes).
Monitor recent attempts in Connections → Monitor → Outbound webhook deliveries.

Make handlers idempotent — dedupe on session_id, order_id, case_id, plus event.

Get started

Integrate by client type

Capabilities — prevention

Capabilities — events & ops

Dashboard

Core concepts

Reference

Event catalog (16 events)

Payload examples

`transaction.created` (assess approve / review / challenge)

`case.recommended`

`assess.outcome_applied`

`transaction.blocked` (assess decline)

`fraud.detected` (report-fraud)

Signature headers

Delivery & retries

​Event catalog (16 events)

​Payload examples

​transaction.created (assess approve / review / challenge)

​case.recommended

​assess.outcome_applied

​transaction.blocked (assess decline)

​fraud.detected (report-fraud)

​Signature headers

​Delivery & retries

​Related

Event catalog (16 events)

Payload examples

`transaction.created` (assess approve / review / challenge)

`case.recommended`

`assess.outcome_applied`

`transaction.blocked` (assess decline)

`fraud.detected` (report-fraud)

Signature headers

Delivery & retries

Related