HookLens Docs

Introduction

Welcome to HookLens

African fintech providers like Paystack, Flutterwave, and Monnify are critical to regional commerce. However, each implements webhook delivery, signature validation, and retry semantics differently.

HookLens provides a self-hosted, centralized webhook gateway that normalizes ingestion, guarantees delivery via decoupled queueing, and drastically reduces debugging time through AI-assisted failure diagnostics.

Opinionated Technical Architecture

To ensure high availability and prevent provider timeouts, ingestion must be strictly decoupled from delivery. Our architecture includes:

  • Ingestion Layer: Optimized for speed. It performs synchronous signature verification, writes the raw event to Postgres, pushes it to Redis, and immediately returns a 200 OK.
  • Queue System: Acts as the shock absorber. Handles job locking, delayed execution, and exponential backoff without tying up thread pools.
  • Delivery Worker: Consumes events, fetches payloads, makes the HTTP POST request to your endpoint, and updates delivery attempt records synchronously.