# WordPress settings & webhooks

# WordPress settings & webhooks

The reference for everything beyond the [basic setup](/guides/platforms/wordpress/): 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](https://business.frak.id/), 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](https://business.frak.id/), 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](https://github.com/frak-id/wallet/releases?q=wordpress+plugin&expanded=true).

## For developers

[Purchase webhook reference](/developers/api/webhook/)