PassiveWP logo
Help CenterTroubleshooting / Links and Tracking

Webhook Signature Mismatch

Step-by-step help for troubleshooting / links and tracking, including where to click, what to change, and how to confirm it worked.

Troubleshooting / Links and Tracking4 guided stepsCtrl/Cmd + K search
Ctrl/Cmd + K

Webhook Signature Mismatch

Troubleshooting / Links and Tracking

How this article is organized
Go hereUse the route chips to see the exact menu path before you click.
Do thisFollow the action callout to make the change without extra guesswork.
ConfirmUse the verification cue to make sure the fix actually worked.

Receiving system rejects webhook requests as invalid signature.


Where to Check in PassiveWP

WordPress Admin -> PassiveWP -> Branded Links -> My Links

Step-by-Step Fix Walkthrough

Fix Step 1: Confirm both sides use identical webhook secret.

Go here WordPress AdminPassiveWPBranded LinksMy Links

Do this In WordPress AdminPassiveWPBranded LinksMy Links, do this in order: open the relevant panel, find the control related to "Confirm both sides use identical webhook secret.", apply one change, click Save/Run, then reload once to confirm it stuck.

Confirm Private-window click tests should route correctly and keep required attribution params.

Fix Step 2: Validate raw request body before parsing.

Go here WordPress AdminPassiveWPBranded LinksMy Links

Do this Open WordPress AdminPassiveWPBranded LinksMy Links, click the test/validate action in that screen, and wait for the result notice before continuing.

Confirm Private-window click tests should route correctly and keep required attribution params.

Fix Step 3: Allow small clock skew for timestamp checks.

Go here WordPress AdminPassiveWPBranded LinksMy Links

Do this In WordPress AdminPassiveWPBranded LinksMy Links, do this in order: open the relevant panel, find the control related to "Allow small clock skew for timestamp checks.", apply one change, click Save/Run, then reload once to confirm it stuck.

Confirm Private-window click tests should route correctly and keep required attribution params.

Fix Step 4: Retest with one click and one conversion event.

Go here WordPress AdminPassiveWPBranded LinksMy Links

Do this Open WordPress AdminPassiveWPBranded LinksMy Links, click the test/validate action in that screen, and wait for the result notice before continuing.

Confirm Private-window click tests should route correctly and keep required attribution params.

Most Common Causes

  • Secret mismatch between PassiveWP and receiver.
  • Timestamp/signature validation window too strict.
  • Payload transformed before signature verification.

How to Prevent It Next Time

  • Rotate secrets carefully with overlap windows.
  • Document expected signature headers and format.
  • Monitor webhook error logs continuously.

When to Contact Support

  • You completed every fix step and still get the same error.
  • The issue impacts revenue-critical pages or high-volume campaigns.
  • You can share timestamps, affected link/product IDs, and screenshots of the exact error state.

Was this article helpful?

Ready to build better affiliate pages and get more from your traffic?

Build cleaner money pages, keep product data fresh, and know what to improve next without stacking more tools on top of WordPress.

PassiveWP dashboard overview