# Paramètres WordPress et webhooks

# Paramètres WordPress et webhooks

Le guide de référence pour aller plus loin après la [configuration de base](/guides/platforms/wordpress/) : prérequis, champs de marque, suivi des commandes et solutions en cas de problème.

## Prérequis

- **WordPress 6.4+** et **PHP 8.0+**.
- **WooCommerce** est facultatif. Vous en avez besoin uniquement pour le suivi des achats, et le plugin est compatible HPOS.
**Vous utilisez un sous-domaine ?:** Si votre boutique fonctionne sur un sous-domaine (comme `shop.your-store.com`) différent du domaine que vous avez enregistré, ouvrez l'onglet **Domaines autorisés** dans votre tableau de bord pour l'ajouter avant l'installation. Sinon, le suivi ne pourra pas se connecter.

## Champs de marque

Dans **Réglages → Frak**, sous la section **Website Information**, vous pouvez choisir ce que vos clients voient dans la fenêtre Frak :

- **App Name** (Nom de l'application) : correspond par défaut au nom de votre site. Cliquez sur **Use Site Name** pour le remplir automatiquement.
- **Logo URL** (URL du logo) : correspond par défaut à l'icône de votre site. Cliquez sur **Use Site Icon** ou importez votre propre image.

Le reste des textes et des traductions est géré directement depuis le [tableau de bord Frak](https://business.frak.id/). La page WordPress ne concerne donc que ces deux champs. Cliquez sur **Save Settings** une fois terminé.

## Suivi des commandes avec WooCommerce

Une fois votre clé collée et enregistrée, la section **WooCommerce Webhook** permet de signaler à Frak chaque nouvelle commande, afin d'attribuer les récompenses sur les ventes réelles.

1. Cliquez sur **Set up webhook**. (Ce bouton reste désactivé tant que votre compte marchand n'est pas connecté et que la clé n'est pas enregistrée.)
2. Vérifiez la présence du bandeau vert : **WooCommerce webhook active**. La ligne **Secret in WooCommerce** doit indiquer **matches the secret saved above**.

C'est tout. WooCommerce gère automatiquement les tentatives d'envoi et la distribution, vous n'avez donc rien à configurer de plus.
**Où trouver ces éléments:** - Le webhook lui-même : **WooCommerce → Réglages → Avancé → Webhooks**.
- Les journaux d'envoi (logs) : **WooCommerce → État → Logs**, source `webhooks-delivery`.

Si le bandeau est jaune au lieu de vert, le message vous indique précisément le problème et le bouton sur lequel cliquer (**Re-enable webhook**, **Sync webhook**, etc.).

## Dépannage

- **Le statut indique « Not resolved for this domain ».** Ajoutez le domaine de votre site sous **Domaines autorisés** dans le [tableau de bord Frak](https://business.frak.id/), puis cliquez sur **Refresh Merchant** dans la page de configuration du plugin. (Votre domaine principal fonctionne automatiquement, seuls les sous-domaines ont besoin d'être ajoutés.)
- **Le suivi s'est arrêté après un changement de domaine.** Même solution : ajoutez le nouveau domaine, puis cliquez sur **Refresh Merchant**. Le webhook se redirigera automatiquement.
- **Message « Secret does not match ».** Copiez à nouveau la clé depuis la section **Purchase Tracker → WooCommerce** de votre tableau de bord, collez-la dans **Réglages → Frak**, enregistrez, puis cliquez sur **Sync webhook**.
- **Alerte « Vendor folder missing ».** Vous avez décompressé une version de développement au lieu de la version prête à l'emploi. Téléchargez le fichier `frak-integration.zip` depuis la [page des versions](https://github.com/frak-id/wallet/releases?q=wordpress+plugin&expanded=true).

## Pour les développeurs

[Référence du webhook d](/developers/api/webhook/)