Webhook Connection Issues

Fixing Webhook Problems

Get automatic updates working!

__________________________________________________

Problem: Updates Not Syncing

Symptoms:

• Delivery completed
• WooCommerce still shows "Processing"
• No order notes from Shaloz
• No automatic updates

Cause: Webhooks not configured or broken

__________________________________________________

Check Webhook Setup

Verify Configuration:

In WooCommerce:

1. Settings → Shipping → Shaloz
2. Webhook Secret entered?
3. Click "Test Webhook"
4. Should show success

In Shaloz Portal:

1. Settings → Webhook Configuration
2. Webhook URL entered?
3. Should be your WooCommerce URL

__________________________________________________

Test Webhook

Click "Test Webhook" Button:

• In WooCommerce settings
• Should show success
• If error: See fixes below

__________________________________________________

Common Errors

"Invalid Webhook Signature":

• Secret doesn't match
• Re-copy from Portal
• Paste in WooCommerce
• Save and test again

"Webhook URL Not Accessible":

• URL incorrect
• Server blocking webhooks
• Not HTTPS (required for production)

Fix:

• Verify URL exact
• Must be HTTPS
• Contact web host about firewall

__________________________________________________

HTTPS Required

Production Needs HTTPS:

• Your site must have SSL
• Look for padlock in browser
• http:// won't work
• https:// required

Get SSL:

• Contact web host
• Usually free
• Essential for webhooks

__________________________________________________

Server Firewall

Webhooks Incoming:

• From Shaloz to your server
• Firewall might block
• Contact web host
• Ask: "Can my server receive webhooks from Shaloz?"

__________________________________________________

Re-Configure Webhooks

Start Fresh:

1. Copy Webhook Secret from Portal:

• portal.shaloz.com → Settings
• Copy webhook secret

2. Paste in WooCommerce:

• WooCommerce settings
• Webhook Secret field
• Paste
• Save

3. Copy Webhook URL from WooCommerce:

• Shown in settings
• Copy entire URL

4. Paste in Portal:

• Portal Settings
• Webhook URL field
• Paste
• Save

5. Test:

• Click "Test Webhook" in WooCommerce
• Should work now

__________________________________________________

Debug Webhook Logs

Enable Debug:

1. Debug Mode ON in plugin
2. Place test order
3. Fulfill in Portal
4. Check logs:
5. WooCommerce → Status → Logs
6. Look for webhook attempts
7. See errors

__________________________________________________

Manual Refresh

If Webhooks Won't Work:

• Open order in WooCommerce
• Click "Refresh Status" button
• Gets latest status manually
• Not ideal but works

__________________________________________________

Need Help?

Webhook Issues: help.shaloz.com

Server Questions: Contact web host

Include: Error messages, webhook test results