Common errors

This page covers common RelayKit setup and runtime issues.

403 invalid signature

RelayKit could not verify the request signature.

Check that:

• The correct secret is configured
• The provider is signing the raw request body
• The signature header name matches your provider class
• Your local tunnelling tool is not modifying the request body

404 provider not found

The provider key in the URL does not match a configured provider.

/webhooks/payments

Requires:

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

Handler not found

The event was verified, but no handler was mapped.

Add the event to the events array or configure a fallback handler.

Delivery keeps retrying

A handler is throwing an exception. Check the delivery log for the exception message and stack trace.