Webhooks

Event delivery model

Webhook events notify you when enrichment jobs transition state, reducing polling overhead.

Example event

{
  "event": "txen.enrichment.completed",
  "occurred_at": "2026-03-24T09:45:00Z",
  "data": {
    "transaction_id": "txn_123",
    "status": "completed"
  }
}

Signature verification

function verifySignature(rawBody: string, signature: string, secret: string) {
  // Replace with your HMAC verification implementation.
  return Boolean(rawBody && signature && secret);
}

Receiver best practices

• Acknowledge quickly.
• Process asynchronously.
• Deduplicate by event id.