HookRelay

Local Razorpay webhook debugger for development.

Apr 2026 – Jun 2026

Solo Project

HookRelay receives Razorpay webhooks through local or Cloudflare ingress, stores events locally, forwards payloads to a local handler, and gives developers a dashboard to inspect signatures, duplicates, delivery status, and replay stored events.

View on GitHub

The Problem

Razorpay webhooks cannot reach a local development server directly. Developers often need a tunnel, a forwarding target, signature checks, event history, and replay tools to debug webhook delivery without touching production code.

Key Features

Captures and inspects incoming Razorpay webhooks
Validates signatures and detects duplicate events
Forwards payloads to a local handler with failure diagnostics
Replays stored events on demand

My Solution

HookRelay runs on the developer machine with Docker Compose. It exposes a webhook endpoint, captures each event, validates Razorpay signatures when a secret is configured, forwards the payload to a local app, and keeps replayable event history in local PostgreSQL.

Tech Stack

Python

Docker Compose

PostgreSQL

React

What I Learned

I learned a lot about network protocols, reverse proxies, and building reliable systems. The project improved my understanding of distributed systems and reliability patterns.