WordPress settings & webhooks

The reference for everything beyond the basic setup: requirements, brand fields, order tracking, and what to do when something looks off.

Requirements

• WordPress 6.4+ and PHP 8.0+.
• WooCommerce is optional. You only need it for purchase tracking, and the plugin is HPOS-compatible.

Using a subdomain?

If your store runs on a subdomain (like shop.your-store.com) that’s different from the domain you registered, open Allowed Domains in the dashboard and add it before installing. Otherwise tracking won’t connect.

Brand fields

In Settings → Frak, under Website Information, you can set what customers see in the Frak window:

• App Name: defaults to your site name. Click Use Site Name to fill it.
• Logo URL: defaults to your site icon. Click Use Site Icon, or upload your own.

The rest of the wording and translations are managed from the business dashboard, so the WordPress page only covers these two fields. Click Save Settings when done.

Order tracking with WooCommerce

After you paste your key and save, the WooCommerce Webhook section lets Frak know when an order is placed, so rewards go out on real sales.

1. Click Set up webhook. (It stays disabled until your merchant is connected and the key is saved.)
2. Look for the green banner: WooCommerce webhook active. The Secret in WooCommerce line should read matches the secret saved above.

That’s the whole setup. WooCommerce handles retries and delivery on its own, so you don’t have to maintain anything.

Where things live

• The webhook itself: WooCommerce → Settings → Advanced → Webhooks.
• Delivery logs: WooCommerce → Status → Logs, source webhooks-delivery.

If the banner is yellow instead of green, the message tells you exactly what’s off and which button to click (Re-enable webhook, Sync webhook, and so on).

Troubleshooting

• Merchant says “Not resolved for this domain”. Add your site’s domain under Allowed Domains on the dashboard, then click Refresh Merchant on the plugin settings page. (Your main domain works automatically; only subdomains need adding.)
• Tracking stopped after a domain change. Same fix: add the new domain, then click Refresh Merchant. The webhook re-points itself automatically.
• “Secret does not match”. Re-copy the key from Purchase Tracker → WooCommerce in the dashboard, paste it back in Settings → Frak, save, then click Sync webhook.
• “Vendor folder missing” notice. You unzipped a developer copy instead of the packaged release. Download frak-integration.zip from the releases page.

For developers

Purchase webhook referenceHow Frak receives and verifies order updates, for custom integrations.