Configuration

RelayKit keeps most behaviour in a single configuration file.

Route prefix

'route_prefix' => 'webhooks',

This creates endpoints such as /webhooks/payments and /webhooks/forms.

Queue name

'queue' => 'webhooks',

Use a dedicated queue if webhook work should not block other jobs in your application.

Payload storage

'store_payloads' => true,

When enabled, RelayKit stores the original request body for debugging and audit trails.

For sensitive providers, you may disable payload storage or redact selected fields.

Provider registration

'providers' => [
    'payments' => App\Webhooks\Providers\PaymentProvider::class,
    'forms' => App\Webhooks\Providers\FormProvider::class,
],

Each provider key becomes part of the public webhook URL.

Retry policy

'retries' => [
    'max_attempts' => 3,
    'backoff' => [60, 300, 900],
],

Backoff values are defined in seconds.