Troubleshooting

Antes de abrir un ticket, pruebe estos diagnósticos rápidos. Resuelven el 70% de los problemas comunes.

El kiosko no responde

Síntomas: tableta congelada, la búsqueda no devuelve resultados.

1. ¿Internet en el campus? Otro dispositivo navegando — sí o no.
2. Refrescar app: cerrar y abrir.
3. Reiniciar tableta: apagar 30 s, encender.
4. Verificar versión: si > 30 días sin update, actualizar desde App Store / Play.
5. Revisar Status: confirma si es plataforma o local.

Si nada funciona y un culto está en curso: modo papel (anote nombres, ingrese al final).

Donaciones rechazadas masivamente

Síntomas: varios donantes en el mismo culto reportan rechazo.

1. ¿Tarjetas distintas o la misma? Si misma tarjeta = problema del banco. Si distintas y simultáneo = puede ser nuestro o Stripe.
2. Revisar Status de Stripe y Ministrium.
3. Ver dashboard de Stripe directamente: si Stripe rechaza con charge_declined, no es nuestro.
4. Si todo se ve normal: Reportar incidente Sev1.

Email no llega

Síntomas: miembro dice “no recibí su correo”.

1. Carpeta de spam: pídale revisar primero.
2. ¿Está opted in? CRM → [Miembro] → Consentimientos. Si email_opt_in = false, no le mandamos.
3. ¿Bounce histórico? CRM → [Miembro] → Comunicaciones. Si hay bounces, su email puede estar marcado como inválido.
4. Verificar que el campaña salió: Comunicaciones → Campañas → [Campaña] → Detalles debe decir delivered=true para ese miembro.
5. Dominio en cuarentena: si su iglesia tuvo > 0.1% de quejas, su dominio está pausado. Aviso por email a org_admin.

Reporte tarda mucho

Síntomas: dashboard de salud o crecimiento se queda cargando > 30 s.

1. Tamaño del rango: pruebe con un rango menor (3 meses en lugar de 5 años).
2. Filtros: agregue filtro por campus o por categoría — reduce data.
3. Hora pico: domingos 11-14 hora central tiene más carga; pruebe a otra hora.
4. Cache: el primer load es lento, los siguientes < 5 s.
5. Plan: Starter tiene cómputo compartido y puede ralentizar; upgrade a Growth+ para reportes dedicados.

Sincronización QuickBooks falló

Síntomas: una donación quedó como sync_failed.

1. Integraciones → QBO → Errores: leer mensaje exacto de QBO.
2. Causa común 1: cliente con email duplicado en QBO. Edite manualmente o desactive el duplicado.
3. Causa común 2: fondo no mapeado. Ir a Integraciones → QBO → Mapeo.
4. Causa común 3: token de QBO caducó. Reconectar desde la página de integración.
5. Causa común 4: cuota diaria de QBO API agotada (raro). Esperar 24 h y reintentar.

MFA bloqueado

Síntomas: no puedo entrar, perdí el dispositivo del Authenticator.

1. Use código de respaldo: si tiene los 10 que descargó al activar.
2. Otro org_admin lo resetea: Configuración → Usuarios → [Su usuario] → Resetear MFA.
3. Si es el único org_admin: recovery@ministrium.com con ID y respuestas de seguridad. 24-48 h.

Webhook no llega a mi backend

Síntomas: configuré webhook en Ministrium pero no recibo nada.

1. Configuración → API → Webhooks → [Endpoint] → Logs muestra cada intento. Vea código de respuesta:
   • 200/201/204: nuestro envío fue OK; el problema está en cómo procesa su backend.
   • 5xx: su servidor erroreó; revise sus logs.
   • Connection refused: nuestro server no llegó. Firewall?
   • Timeout: su server tarda > 3s. Procese asíncrono.
2. Webhook desactivado: tras 5 fallos consecutivos, lo desactivamos. Reactivar en mismo lugar.
3. Verifique firma: si su backend rechaza por firma inválida, vea Webhooks.

API devuelve 401 Unauthorized

1. Token expirado: PAT vence a 90 días. Generar nuevo.
2. Token revocado: alguien con acceso lo revocó. Generar nuevo.
3. X-Tenant ausente o incorrecto: ver Convenciones REST.
4. Rol del token sin scope: regenerar pidiendo scopes correctos.

Búsqueda no encuentra a un miembro que sé que existe

1. Filtro de campus: la búsqueda por default es del campus actual. Cambie a “Todos los campuses”.
2. Activos vs inactivos: por default sólo busca activos. Toggle “Incluir inactivos”.
3. Acentos / mayúsculas: la búsqueda ignora ambos, pero verifique typos.
4. Índice no actualizado: muy raro, pero si acaba de crearlo (< 30 s), espere.

Notificación push no llega

1. ¿Permisos del dispositivo? Settings de iOS/Android → Ministrium → Notificaciones ON.
2. ¿Categoría silenciada? Mi cuenta → Notificaciones → revisar toggles.
3. ¿Token activo? Si la app no se abrió en > 28 días, el token puede estar muerto. Pídale al miembro abrir la app una vez.
4. ¿Hard cap excedido? Plan Starter tiene 5.000 push/mes; pasado eso, no salen.

”No puedo hacer X, dice que no tengo permiso”

1. Identifique su rol: Mi cuenta → Mi rol.
2. Revise Roles y permisos para ver qué incluye.
3. Si necesita permiso adicional: pídale a un org_admin que lo otorgue temporal o que cambie su rol.