Solutions aux problèmes les plus fréquents. Commencez toujours par consulter l'onglet Journaux du plugin (filtré par niveau error) pour obtenir le message d'erreur exact.
Après avoir saisi et tenté d'activer la licence, le statut reste à Manquant ou passe à Erreur.
Vérifier la clé
Copiez la clé depuis votre email et re-collez-la dans le champ. Assurez-vous qu'il n'y a pas d'espace ou de caractère invisible en début/fin.
Vérifier la connectivité
Votre serveur doit pouvoir joindre stackrio.fr sur le port 443. Testez depuis un terminal SSH : curl -I https://stackrio.fr. Si la commande échoue, contactez votre hébergeur.
Consulter les journaux
Dans l'onglet Journaux, filtrez par source license et niveau error. Le message exact du serveur y est enregistré.
Licence déjà activée ailleurs
Si vous avez changé de domaine sans désactiver la licence, elle est encore liée à l'ancien site. Contactez le support avec votre clé pour libérer l'installation.
Erreur OAuth — "Token expiré" ou "Autorisation refusée"
La synchronisation échoue avec une erreur liée au token OAuth SumUp.
Reconnecter via OAuth
Dans Réglages → Identifiants, cliquez sur Reconnecter via OAuth. Vous serez redirigé vers SumUp pour réautoriser l'accès. C'est la solution la plus simple et la plus fiable.
Vérifier l'application SumUp
Connectez-vous sur developer.sumup.com et vérifiez que votre application est toujours active. Si vous avez changé le mot de passe SumUp, les tokens sont révoqués.
Vérifier l'URL de callback
L'URL de callback configurée dans SumUp doit correspondre exactement à celle affichée dans les réglages du plugin. Une différence (HTTP vs HTTPS, avec/sans slash final) bloque l'OAuth.
La synchronisation ne remonte aucune transaction
Le run se termine sans erreur mais avec 0 transaction traitée.
Vérifier la date de départ
Si la date de départ est trop récente (ou dans le futur), il n'y a pas de transactions SumUp dans cette plage. Définissez une date dans le passé.
Tester la connexion SumUp
Dans Réglages → Identifiants, vérifiez que la connexion OAuth est active. Consultez les journaux si une erreur est remontée.
Vérifier le code marchand
Le Code marchand doit être exactement celui de votre compte SumUp (visible sur me.sumup.com). Un code incorrect retourne une liste de transactions vide sans erreur.
Vérifier les droits
Si vous utilisez une clé API statique, vérifiez qu'elle a bien les droits de lecture sur les transactions (et non uniquement les paiements).
Toutes les transactions restent en attente
La sync importe des transactions mais elles se retrouvent toutes dans la file d'attente.
Mapping incomplet
C'est la cause la plus fréquente. Allez dans l'onglet Correspondances produits, importez le catalogue CSV SumUp et vérifiez que les correspondances sont créées.
Articles renommés dans SumUp
Si vous avez modifié le nom d'un article dans SumUp, le plugin ne trouve plus la correspondance. Réimportez le CSV et vérifiez les articles sans correspondance.
Produit WooCommerce supprimé
Si un produit WooCommerce lié à un mapping a été supprimé, les transactions de cet article iront en attente. Recréez le mapping avec un nouveau produit.
Le stock WooCommerce n'est pas mis à jour
La sync s'exécute sans erreur mais le stock ne change pas.
Mode simulation actif
Si le mode simulation est activé, aucune modification de stock n'est appliquée. Vérifiez dans Réglages → Comportement de synchro (section Mode simulation).
Gestion du stock désactivée sur le produit
Dans WooCommerce, ouvrez le produit → onglet Inventaire → vérifiez que Activer la gestion du stock pour ce produit est coché.
Consulter les logs
Dans l'onglet Journaux, cherchez les entrées de la sync concernée. Un message Stock management disabled confirme que c'est le problème du point précédent.
La synchronisation automatique ne se déclenche pas
La sync auto est activée dans les réglages mais aucun run automatique n'a lieu.
Ce plugin utilise WP-Cron, le système de planification natif de WordPress. WP-Cron se déclenche lors des visites du site. Sur un site peu fréquenté, les runs peuvent avoir du retard — parfois de plusieurs heures. Pour une planification fiable, désactivez WP-Cron dans WordPress et configurez un vrai cron système à la place.
Vérifier que la sync auto est activée
Dans Réglages → Comportement de synchro, vérifiez que l'option Activer la synchronisation automatique via WP-Cron est bien cochée et qu'un intervalle est sélectionné.
Vérifier le planning WP-Cron
Allez dans WP Admin → Outils → Actions planifiées (si disponible via une extension). Recherchez suwi_auto_sync_event. L'action doit apparaître avec un prochain run planifié. Si elle est absente, désactivez puis réactivez la sync auto dans les réglages.
Configurer un cron système
Pour une planification fiable indépendante du trafic, désactivez WP-Cron dans wp-config.php et configurez une tâche cron système.
Configurer un vrai cron système
Ajoutez dans wp-config.php pour désactiver WP-Cron :
define('DISABLE_WP_CRON', true);
Puis ajoutez une entrée dans votre crontab système (toutes les minutes) :
