Un gateway Stripe in Zoho Books è entrato in uno stato "fantasma" corrotto in cui l'interfaccia utente mostra stati contraddittori (un punto riporta Stripe come Attivo ma mancano i dettagli dell'account, mentre l'elenco dei gateway mostra Stripe come Inattivo e richiede "Configura Ora"). Il record del gateway nel backend di Zoho necessita di un reset manuale per poter riconnettere Stripe in modo pulito [1].
Cosa significa — Spiegazione concreta legata alla superficie API di Zoho
Il connettore Stripe in Zoho Books mantiene un record del gateway nel backend che contiene token OAuth, metadati dell'account e metodi di pagamento abilitati. Se tale record diventa orfano o incoerente, le schermate front-end possono leggere campi diversi e visualizzare stati contraddittori: un componente legge un flag "attivo" mentre un altro legge metadati dell'account mancanti, e l'interfaccia utente blocca le modifiche perché il record di backend è malformato. Quel record del gateway corrotto impedisce una nuova stretta di mano OAuth o un normale flusso di eliminazione/ricreazione e richiede un reset manuale del backend da parte del Supporto Zoho per rimuovere la voce orfana, in modo che l'integrazione possa essere ristabilita [1][6].
Cause comuni
- Riconnessione interrotta o fallita durante il flusso OAuth lascia una riga del gateway parzialmente creata nel backend [1].
- Accesso revocato nella Dashboard Stripe senza una disconnessione pulita in Zoho, lasciando discrepanze nei metadati tra i sistemi [1][6].
- Voci duplicate o orfane del gateway da tentativi passati, importazioni di organizzazioni o migrazioni di account che l'interfaccia utente non può eliminare [1].
- Bug di sincronizzazione UI/backend in cui il flag "attivo" del gateway e i metadati dei metodi di pagamento divergono, producendo schermate conflittuali [1].
Come risolvere
- Riprova i passaggi dell'interfaccia utente: Impostazioni → Pagamenti Online → Gateway di Pagamento → Carta di Credito/Debito → Stripe, fai clic su Modifica, quindi su Disconnetti o Rimuovi se disponibile, e poi riconnetti tramite il flusso OAuth di Stripe.
- In Stripe, revoca l'accesso a Zoho: accedi alla Dashboard → Impostazioni → Account connessi o Chiavi API, rimuovi le connessioni Zoho, quindi tenta la riconnessione da Zoho Books. Registra i timestamp e acquisisci screenshot per ogni tentativo [1][6].
- Se l'interfaccia utente mostra ancora stati contraddittori, raccogli i dettagli diagnostici: nome dell'organizzazione, ID dell'organizzazione, data center (mostrato nel banner del Centro Assistenza), screenshot esatti di entrambe le schermate, log della console del browser dal momento dell'azione e l'elenco dei passaggi provati e i relativi timestamp.
- Apri un ticket di Supporto Zoho da Centro Assistenza > Contatta il Supporto (includi "Richiesta: reset backend del record del gateway Stripe" nell'oggetto) e allega i dati diagnostici. Richiedi esplicitamente che il Supporto elimini o resetti la voce del gateway Stripe nel backend in modo da poter eseguire una nuova connessione OAuth [1].
- Consenti al Supporto di eseguire il reset e quindi completa il flusso OAuth standard di Stripe in Zoho Books per riconfigurare i metodi di pagamento. Mantieni aperta una sessione di amministrazione e testa con una piccola transazione o in modalità di test.
Quando escalare
Escala al Supporto Zoho quando ripetute disconnessioni dall'interfaccia utente, revoche di Stripe e riconnessioni di sessione del browser falliscono e l'interfaccia utente mostra ancora stati conflittuali Attivo/Inattivo — ciò indica un record di backend orfano che solo il Supporto può rimuovere. Se i pagamenti delle fatture o la fatturazione dei clienti sono bloccati, scala immediatamente con il pacchetto diagnostico.
[1]: Stripe gateway stuck in corrupted state — manual backend reset required (https://help.zoho.com/portal/en/community/topic/stripe-gateway-stuck-in-corrupted-state-%e2%80%94-manual-backend-reset-required)
[6]: Reconciliation gets easy as Stripe goes 'Intrinsic' with Zoho Books (https://www.zoho.com/blog/books/reconciliation-stripe-integration-with-zoho-books.html)