Una pasarela Stripe en Zoho Books ha entrado en un estado "fantasma" corrupto donde la interfaz de usuario muestra estados contradictorios (un lugar informa que Stripe está Activo pero faltan detalles de la cuenta, mientras que la lista de pasarelas muestra Stripe como Inactivo y solicita "Configurar Ahora"). El registro de la pasarela en el backend de Zoho necesita un restablecimiento manual para que pueda reconectar Stripe limpiamente [1].
Qué significa — explicación concreta vinculada a la superficie de la API de Zoho
El conector de Stripe en Zoho Books mantiene un registro de pasarela en el backend que almacena tokens OAuth, metadatos de la cuenta y métodos de pago habilitados. Si ese registro queda huérfano o inconsistente, las pantallas front-end pueden leer diferentes campos y mostrar estados contradictorios: un componente lee una bandera "activa" mientras que otro lee metadatos de cuenta faltantes, y la interfaz de usuario bloquea las ediciones porque el registro del backend está mal formado. Ese registro de pasarela roto impide una nueva autenticación OAuth o un flujo normal de eliminación/recreación y requiere un restablecimiento manual del backend por parte del Soporte de Zoho para eliminar la entrada huérfana y así restablecer la integración [1][6].
Causas comunes
- Reconexión interrumpida o fallida durante el flujo OAuth deja una fila de pasarela medio creada en el backend [1].
- Acceso revocado en el Panel de Control de Stripe sin una desconexión limpia en Zoho, dejando desajustes de metadatos entre sistemas [1][6].
- Entradas de pasarela duplicadas u huérfanas de intentos pasados, importaciones de organizaciones o migraciones de cuentas que la interfaz de usuario no puede eliminar [1].
- Error de sincronización UI/backend donde la bandera "activa" de la pasarela y los metadatos del método de pago divergen, produciendo pantallas conflictivas [1].
Cómo solucionarlo
- Intente los pasos de la interfaz de usuario una vez más: Configuración → Pagos en Línea → Pasarelas de Pago → Tarjeta de Crédito/Débito → Stripe, haga clic en Editar, luego en Desconectar o Eliminar si está disponible, y luego vuelva a conectar a través del flujo OAuth de Stripe.
- En Stripe, revoque el acceso de Zoho: inicie sesión en Panel de Control → Configuración → Cuentas conectadas o Claves API, elimine las conexiones de Zoho, luego intente la reconexión desde Zoho Books. Registre las marcas de tiempo y capture capturas de pantalla de cada intento [1][6].
- Si la interfaz de usuario todavía muestra estados contradictorios, recopile detalles de diagnóstico: nombre de la organización, ID de la organización, centro de datos (mostrado en el banner del Centro de Ayuda), capturas de pantalla exactas de ambas pantallas, registros de la consola del navegador del momento de la acción, y la lista de pasos que intentó y las marcas de tiempo.
- Abra un ticket de Soporte de Zoho desde Centro de Ayuda > Contactar Soporte (incluya "Solicitud: restablecimiento manual del registro de pasarela Stripe" en el asunto) y adjunte los diagnósticos. Solicite explícitamente que el Soporte elimine o restablezca la entrada de la pasarela Stripe en el backend para que pueda ejecutar una conexión OAuth nueva [1].
- Permita que el Soporte realice el restablecimiento y luego complete el flujo OAuth estándar de Stripe en Zoho Books para reconfigurar los métodos de pago. Mantenga una sesión de administrador abierta y pruebe con una transacción pequeña o en modo de prueba.
Cuándo escalar
Escale al Soporte de Zoho cuando las desconexiones repetidas de la interfaz de usuario, las revocaciones de Stripe y las reconexiones de sesión del navegador fallen y la interfaz de usuario siga mostrando estados conflictivos Activo/Inactivo — eso indica un registro de backend huérfano que solo el Soporte puede eliminar. Si la facturación del cliente o los pagos de facturas están bloqueados, escale inmediatamente con el paquete de diagnóstico.
[1]: Pasarela Stripe atascada en estado corrupto — se requiere restablecimiento manual del backend (https://help.zoho.com/portal/en/community/topic/stripe-gateway-stuck-in-corrupted-state-%e2%80%94-manual-backend-reset-required)
[6]: La conciliación se vuelve fácil a medida que Stripe se vuelve "Intrínseco" con Zoho Books (https://www.zoho.com/blog/books/reconciliation-stripe-integration-with-zoho-books.html)