Soluciona problemas de conexión y sincronización de Stripe en Piraja CRM. Verifica el estado de la conexión, permisos y flujo de datos.
Declaración del problema
El problema
Stripe no está conectado, o los datos (facturas, pagos, clientes) no se sincronizan como se esperaba entre Stripe y Piraja. Esto puede significar:
- La integración de Stripe no está conectada o se ha desconectado
- La conexión se realiza correctamente, pero los datos no aparecen en el módulo de Finanzas
- Las facturas o pagos creados en Stripe no se muestran en Piraja (o viceversa)
- Ves errores al intentar crear o enviar una factura
Escenarios comunes
Escenario 1: Stripe no conectado
- Abres Finanzas o la configuración de Stripe y ves un aviso para conectar
- No aparece ningún dato de Stripe en el CRM
Escenario 2: Conectado pero sin sincronización
- Stripe aparece como conectado, pero faltan facturas o pagos recientes en Piraja
- La sincronización puede estar retrasada o fallando
Escenario 3: Problemas de permisos o alcance
- La conexión se realizó con permisos limitados
- Algunas funciones de Stripe (por ejemplo, ciertos tipos de pago) pueden no estar disponibles
Verificaciones paso a paso
1. Verifica que Stripe esté conectado
- Ve a la configuración de la integración de Stripe o del módulo de Finanzas (como en tu aplicación).
- Confirma que Stripe esté conectado para tu negocio. Si ves "Conectar Stripe", completa el flujo de OAuth y concede los permisos solicitados.
- Después de conectar, asegúrate de que no estés en un estado desconectado o expirado. Si Stripe estuvo conectado antes y ahora muestra desconectado, intenta reconectar.
2. Verifica la sincronización y errores
- Después de conectar, deja un corto tiempo para la sincronización inicial (unos minutos). Las cuentas grandes pueden tardar más.
- Si creaste una factura o pago en Stripe, actualiza la vista de Finanzas o revisa la lista relevante en Piraja.
- Busca cualquier mensaje de error o advertencia en la configuración de Stripe/Finanzas o en el estado de sincronización. Toma nota del texto exacto si contactas soporte.
3. Permisos y webhooks
- La conexión de Stripe utiliza OAuth y (donde sea aplicable) webhooks. Asegúrate de que tu cuenta de Stripe esté en buen estado y que los webhooks (si se utilizan) no estén deshabilitados o mal configurados.
- Si usas webhooks, confirma que el punto final y los eventos coincidan con lo que Piraja espera. Una configuración incorrecta de webhook puede causar datos faltantes o retrasados.
¿Todavía no funciona?
Si has verificado la conexión, los permisos y la sincronización y el problema persiste, recopila lo siguiente y contacta soporte a support@piraja.io:
- Que estás solucionando la conexión o sincronización de Stripe
- Si Stripe aparece como conectado en tu aplicación
- Cualquier mensaje de error que veas (texto exacto o una captura de pantalla)
- Lo que esperabas ver (por ejemplo, facturas, pagos) y dónde (Stripe vs Piraja)
- Cuándo viste por última vez que los datos se sincronizaban correctamente (si es que alguna vez)
Esta información ayuda al equipo a diagnosticar rápidamente problemas de conexión, alcance o sincronización.
Preguntas frecuentes
¿Necesito una cuenta de Stripe?
Sí. La integración de Stripe conecta tu cuenta existente de Stripe a Piraja. Crea una cuenta en stripe.com si no tienes una, luego conéctala desde la configuración de Finanzas o Stripe.
¿Perderé datos al reconectar Stripe?
Reconectar generalmente restablece el enlace; los datos existentes en Piraja que ya estaban sincronizados normalmente permanecen. La nueva sincronización volverá a extraer de Stripe. Si no estás seguro, contacta soporte a support@piraja.io antes de desconectar.
¿Por qué las facturas creadas en Piraja no se muestran en Stripe (o viceversa)?
La dirección y el tiempo de sincronización dependen de cómo se configure la integración. Algunas acciones crean registros en Stripe primero y luego se sincronizan a Piraja; otras pueden originarse en Piraja. Consulta la Integración de Stripe y Cómo facturar a clientes con Stripe. Si has verificado la conexión y los permisos y los datos aún no coinciden, contacta soporte a support@piraja.io.
¿A quién puedo contactar para obtener ayuda?
Contacta soporte a support@piraja.io.