WooCommerce

Le plugin AffiHQ gère la capture des références, les commandes payées et les remboursements dans WooCommerce. Vous n’avez pas besoin d’exposer une clé API dans WordPress, de transmettre les webhooks Stripe ou de modifier votre checkout.

La V1 associe un produit AffiHQ à un site WordPress et prend en charge les commandes WooCommerce ponctuelles. Le plugin ne transmet pas encore les abonnements, les rétrofacturations et les litiges.

Avant la connexion

Votre site doit utiliser :

• WordPress 6.4 ou une version plus récente ;
• WooCommerce 8.5 ou une version plus récente ;
• PHP 8.3 ou une version plus récente ;
• HTTPS, sauf en développement local.

Dans AffiHQ, la destination du produit doit être la page par laquelle les visiteurs affiliés entrent sur votre boutique WooCommerce. AffiHQ ajoute le paramètre opaque affihq_ref à cette destination.

Installer et associer le plugin

1. Installez et activez AffiHQ for WooCommerce dans WordPress.
2. Dans AffiHQ, ouvrez Produits, modifiez le produit, puis repérez Connexion WooCommerce.
3. Sélectionnez Générer un code d’association. Ce code n’est affiché qu’une fois et expire après dix minutes.
4. Dans WordPress, ouvrez WooCommerce > AffiHQ, collez le code, puis sélectionnez Connecter.
5. Vérifiez que WordPress indique une connexion valide et que la boutique apparaît dans le volet du produit dans AffiHQ.

Le code est échangé de serveur à serveur, ne fonctionne qu’une fois et n’est jamais enregistré par le plugin. L’association fait aussi passer ce produit du routage Payment Link Stripe au mode API. Le compte Stripe connecté n’est pas révoqué.

Après l’arrivée d’un visiteur affilié

1. Le lien affilié enregistre un clic et redirige le visiteur vers la destination du produit avec affihq_ref.
2. Le plugin conserve cette référence opaque dans un cookie propriétaire pendant 90 jours au maximum, puis la copie dans les métadonnées privées de la commande WooCommerce.
3. Une commande payée crée une attribution et un événement de paiement dans AffiHQ.
4. Un remboursement WooCommerce total ou partiel crée la correction correspondante.

Le checkout n’attend jamais AffiHQ. Le plugin ajoute une entrée à une file locale, puis Action Scheduler l’envoie en arrière-plan. Les hooks WooCommerce répétés conservent le même identifiant métier et ne créent donc pas de paiements ou remboursements en double.

Le plugin fonctionne avec le checkout classique, les blocs Panier et Validation de la commande, le stockage historique des commandes et High-Performance Order Storage (HPOS).

Suivre les envois et relancer un échec

Ouvrez WooCommerce > AffiHQ pour consulter les envois en attente ou en échec, la dernière requête réussie et son identifiant. Le plugin retente les erreurs réseau temporaires, les délais dépassés, les limitations de débit et les erreurs serveur. Après avoir corrigé la cause d’un échec définitif, vous pouvez relancer la ligne manuellement.

La file contient les identifiants des événements et leur état d’envoi. Elle ne contient ni email client, ni secret API, ni donnée de paiement.

Déconnecter ou révoquer

Utilisez Déconnecter localement dans WordPress pour retirer les identifiants chiffrés de ce site. Utilisez Révoquer dans le volet du produit AffiHQ pour invalider immédiatement l’identifiant de cette boutique.

La révocation d’une connexion WooCommerce ne supprime pas les clics, paiements, remboursements ou commissions déjà enregistrés dans AffiHQ.

Résoudre un problème

• Le code d’association est refusé : générez un nouveau code et utilisez-le dans les dix minutes. Un code ne peut pas servir deux fois.
• Le site ne valide pas la connexion : vérifiez que WordPress peut envoyer des requêtes HTTPS vers https://affihq.com.
• Une commande payée manque : consultez la file d’envoi et vérifiez que la commande contient une référence affiliée. Le plugin ignore volontairement les commandes sans référence.
• Les liens affiliés ouvrent la mauvaise page : modifiez la destination du produit dans AffiHQ. L’association désactive le Payment Link Stripe précédemment sélectionné pour ce produit.
• Une connexion a été révoquée : générez un nouveau code d’association. L’ancien identifiant ne peut pas être restauré.