Orange Collar Media
Orange Collar Media
DOCS
OCMLABS/MODULE-WEBHOOK · SYSTEM SETTINGS

Configure delivery timeouts, retries, payload logging, and advanced flags in Stores > Configuration

MAGENTO 2.4.7 - 2.4.8 PHP 8.2 - 8.4 LUMA + HYVÄ COMPOSER

Module settings live at Stores > Configuration > OCM Labs > Webhooks (section ocmlabs_webhook). All values are store-view scoped.

OCMLabs Webhooks configuration section

General

FieldDefaultDescription
EnabledYesMaster on/off switch. When off, the observers still run their cheap guard checks but never publish anything to the queue.
Log PayloadsNoWhen on, the rendered request body is stored with each delivery log entry (truncated to 64 KB). Off by default so potentially sensitive payloads are not retained.

Delivery

FieldDefaultDescription
Timeout (seconds)10Total request timeout per delivery attempt.
Max Attempts3Maximum delivery attempts, including the first, before a delivery is marked failed for good.
Retry Base Delay (seconds)60Base value in the exponential backoff formula: delay = base * 2^(failed_attempt - 1).
Max Payload Size (bytes)10485760Hard ceiling on the payload. If exceeded, the delivery fails loudly with an explicit error rather than sending a silently truncated payload.

Maintenance

FieldDefaultDescription
Log Retention (days)90Age at which delivery log rows become eligible for the nightly prune cron (runs at 02:30).

Advanced

FieldDefaultDescription
Enable Custom EventsNoActivates the custom-event plugin so webhooks can subscribe to any Magento event name, not just the 10 curated ones.
Allow Private NetworksNoDevelopment only. Disables the SSRF guard’s rejection of URLs resolving to private, loopback, or link-local addresses.
Allow Insecure URL (HTTP)NoDevelopment only. Permits http:// destination URLs; otherwise only https:// is accepted.

Both Advanced network flags exist so you can point a webhook at a request catcher on localhost or inside a Docker network during development. Leaving them off in production is what makes the SSRF guard meaningful.