Introduction
Introduction
RelayKit PHP is a small webhook handling package for PHP applications. It gives you a consistent way to receive, verify, transform, and dispatch webhook events from external services.
It is designed for teams who want predictable webhook handling without building a large internal framework.
Why it exists
Webhook handling often starts with a single controller method. Over time, that method starts doing too much:
- Reading provider specific headers
- Checking signatures
- Normalising payloads
- Deciding which internal action to run
- Logging failed deliveries
- Retrying transient failures
RelayKit separates those concerns into small classes that can be tested and extended.
Who it is for
RelayKit is useful when your application receives webhooks from services like payment providers, email platforms, form tools, or your own internal systems.
It works especially well for SaaS products that need a clear audit trail of incoming events.
Core ideas
RelayKit is built around four simple concepts:
| Concept | Purpose |
|---|---|
| Provider | Describes how a third party signs and sends requests |
| Event | Represents a normalised webhook payload |
| Handler | Runs your application logic for a specific event |
| Delivery | Stores the processing result for later review |