Dépannage

Corrections rapides pour les problèmes de configuration et d'exécution les plus fréquents.

Le widget ne charge pas

  • Vérifiez que la licence est active dans Réglages → Square Booking → License. Sans elle, les visiteurs voient un shortcode vide.
  • Vérifiez le shortcode [square_booking].
  • Confirmez que Test Square Connection réussit.
  • Inspectez la console pour les conflits JavaScript.

Erreurs API

  • 401 — régénérez le jeton Square.
  • Mauvais environnement — jeton sandbox + Location ID sandbox uniquement (et le même Application ID si les paiements sont activés).
  • Aucun service — publiez les services sur l'emplacement configuré.
  • Plan gratuit avec PAT — passez en OAuth. L'onglet Diagnostics affiche support_seller_level_writes à false.
Diagnostics → Environment : mode de connexion, environnement et Location utilisés.
Diagnostics → Environment : mode de connexion, environnement et Location utilisés.

Le CSS du thème déforme le widget

Depuis 1.3.2, un CSS d'isolation est imprimé en pied de page pour que le thème et les constructeurs (titres, boutons, champs) ne restylent pas le widget. Si l'affichage reste faux, vérifiez le cache et le CSS additionnel du Personnalisateur.

Formulaire carte absent

  • Payment collection doit être Card on file ou Pay in full now, pas Disabled.
  • Le Square Application ID doit être renseigné (sandbox et production sont différents).
  • En OAuth, reconnectez après avoir activé les paiements pour obtenir PAYMENTS_WRITE.

Problèmes de cache

Excluez la page de réservation du cache page (WP Rocket, LiteSpeed, Cloudflare). Dans Réglages → Square Booking → Diagnostics, utilisez Clear Cache après un changement de services ou de personnel. Pour plus de détails, activez le journal de débogage dans le même onglet : il est désactivé par défaut et n'enregistre jamais les e-mails, téléphones ni jetons.

Conversions manquantes

Testez en sandbox avec l'aperçu GTM. Ouvrez Réglages → Square Booking → Diagnostics : l'état de chaque destination, les derniers envois du serveur et des boutons de test qui envoient une réservation fictive. Vérifiez que vos déclencheurs GTM correspondent aux noms d'événements : purchase et les événements du tunnel, ou sqb_booking_confirmed, avec le préfixe réglé dans l'onglet Advanced le cas échéant.

Diagnostics : état de chaque destination, boutons de test et derniers envois du serveur.
Diagnostics : état de chaque destination, boutons de test et derniers envois du serveur.

Multisite

Chaque sous-site nécessite sa propre licence et ses identifiants Square. Le plugin activé en réseau partage le code, pas les options par site. Clear Cache dans Diagnostics peut vider tous les sites du réseau.

Contactez-nous via le formulaire support avec version WordPress, version plugin et capture d'écran.