Une passerelle Stripe dans Zoho Books est entrée dans un état corrompu de type "fantôme" où l'interface utilisateur affiche des statuts contradictoires (un endroit indique que Stripe est actif mais sans détails de compte, tandis que la liste des passerelles affiche Stripe comme inactif et invite à "Configurer maintenant"). L'enregistrement de la passerelle dans le backend de Zoho nécessite une réinitialisation manuelle pour que vous puissiez reconnecter Stripe proprement [1].
Ce que cela signifie — explication concrète liée à la surface de l'API Zoho
Le connecteur Stripe dans Zoho Books conserve un enregistrement de passerelle backend qui contient les jetons OAuth, les métadonnées du compte et les méthodes de paiement activées. Si cet enregistrement devient orphelin ou incohérent, les écrans front-end peuvent lire différents champs et afficher des états contradictoires : un composant lit un indicateur "actif" tandis qu'un autre lit des métadonnées de compte manquantes, et l'interface utilisateur bloque les modifications car l'enregistrement backend est mal formé. Cet enregistrement de passerelle défectueux empêche une nouvelle poignée de main OAuth ou un flux normal de suppression/recréation et nécessite une réinitialisation manuelle du backend par le support Zoho pour supprimer l'entrée orpheline afin que l'intégration puisse être rétablie [1][6].
Causes courantes
- Une reconnexion interrompue ou échouée pendant le flux OAuth laisse une ligne de passerelle partiellement créée dans le backend [1].
- Accès révoqué dans le tableau de bord Stripe sans déconnexion propre dans Zoho, laissant des incohérences de métadonnées entre les systèmes [1][6].
- Entrées de passerelle dupliquées ou orphelines provenant de tentatives passées, d'importations d'organisations ou de migrations de comptes que l'interface utilisateur ne peut pas supprimer [1].
- Bug de synchronisation UI/backend où l'indicateur "actif" de la passerelle et les métadonnées des méthodes de paiement divergent, produisant des écrans conflictuels [1].
Comment le résoudre
- Essayez à nouveau les étapes de l'interface utilisateur : Paramètres → Paiements en ligne → Passerelles de paiement → Carte de crédit/débit → Stripe, cliquez sur Modifier, puis sur Déconnecter ou Supprimer si disponible, et reconnectez-vous ensuite via le flux OAuth Stripe.
- Dans Stripe, révoquez l'accès Zoho : connectez-vous au Tableau de bord → Paramètres → Comptes connectés ou Clés API, supprimez les connexions Zoho, puis tentez la reconnexion depuis Zoho Books. Enregistrez les horodatages et capturez des captures d'écran pour chaque tentative [1][6].
- Si l'interface utilisateur affiche toujours des états contradictoires, rassemblez les détails de diagnostic : nom de l'organisation, ID de l'organisation, centre de données (affiché dans la bannière du Centre d'aide), captures d'écran exactes des deux écrans, journaux de la console du navigateur au moment de l'action, et la liste des étapes que vous avez essayées avec leurs horodatages.
- Ouvrez un ticket de support Zoho depuis le Centre d'aide > Contacter le support (incluez "Demande : réinitialisation du backend de l'enregistrement de la passerelle Stripe" dans l'objet) et joignez les diagnostics. Demandez explicitement au support de supprimer ou de réinitialiser l'entrée de la passerelle Stripe dans le backend afin que vous puissiez effectuer une nouvelle connexion OAuth [1].
- Laissez le support effectuer la réinitialisation, puis terminez le flux OAuth Stripe standard dans Zoho Books pour reconfigurer les méthodes de paiement. Gardez une session administrateur ouverte et testez avec une petite transaction ou en mode test.
Quand escalader
Escaladez vers le support Zoho lorsque les déconnexions répétées de l'interface utilisateur, les révocations Stripe et les reconnexions de session de navigateur échouent et que l'interface utilisateur affiche toujours des états actifs/inactifs conflictuels — cela indique un enregistrement backend orphelin que seul le support peut supprimer. Si la facturation client ou les paiements de factures sont bloqués, escaladez immédiatement avec le package de diagnostic.
[1]: Passerelle Stripe bloquée dans un état corrompu — réinitialisation manuelle du backend requise (https://help.zoho.com/portal/en/community/topic/stripe-gateway-stuck-in-corrupted-state-%e2%80%94-manual-backend-reset-required)
[6]: La réconciliation devient facile car Stripe devient "Intrinsèque" avec Zoho Books (https://www.zoho.com/blog/books/reconciliation-stripe-integration-with-zoho-books.html)