Webhook Billing And Notifications

A webhook-driven billing backend with idempotent event processing, subscription state sync, notification jobs, a queue drain worker, and a typewriter-style admin UI.

Run

npm start

Open http://localhost:3000.

Test

npm test

Webhook Endpoint

POST /webhooks/billing

The endpoint expects a Stripe-style signature header:

stripe-signature: t=<unix timestamp>,v1=<hmac sha256>

The local secret defaults to:

whsec_local_typewriter

Admin Endpoints

• GET /health
• GET /admin/state
• POST /admin/test-events
• POST /admin/drain-notifications

Supported Events

• customer.subscription.created
• customer.subscription.updated
• customer.subscription.deleted
• invoice.payment_succeeded
• invoice.payment_failed
• checkout.session.completed