Configurar Stripe y pagos online

Conecta Stripe y deja lista la operativa de cobros automáticos y pagos online para la campaña de matrícula.

📋 ¿Cuándo usar esto?

Usa esta opción antes de abrir matrículas si el club quiere cobrar el importe de inscripción online o permitir que las familias guarden métodos de pago automáticos para las cuotas periódicas de la temporada.

✨ Qué va a pasar

El club quedará preparado para usar formularios seguros de Stripe, procesar pagos online de matrícula y permitir la configuración de métodos automáticos para cuotas cuando la configuración lo exija o lo permita.

[SCREENSHOT PENDIENTE: Panel de conexión con Stripe mostrando estado de la cuenta conectada, productos sincronizados, y opciones de configuración de pagos]

Pasos

Paso 1: Verifica o conecta Stripe en la cuenta del club

Desde el panel de administración:

• Localiza la sección de integraciones o pagos
• Busca la opción de conectar con Stripe
• Si no está conectado, sigue el proceso de conexión OAuth
• Si ya está conectado, verifica que la conexión está activa

Paso 2: Verifica que la conexión está operativa

Una vez conectado, comprueba:

• El estado de la cuenta Stripe (activa, verificada)
• Que estás en modo producción (no test)
• Que las webhooks están configuradas correctamente
• Que no hay mensajes de error o advertencias

Paso 3: Comprueba productos y precios de matrícula

Verifica que en Stripe existen:

• Los productos de matrícula para cada categoría
• Los precios correctos asociados a cada producto
• Que los nombres y descripciones son claros
• Que la moneda es la correcta (EUR)

Si no existen, puede que el sistema los cree automáticamente o necesites crearlos manualmente.

Paso 4: Configura opciones de pago

Determina qué métodos de pago de Stripe activar:

• Tarjeta de crédito/débito: El más habitual
• Domiciliación SEPA: Para pagos recurrentes en Europa
• Otros métodos: Según disponibilidad en tu país

Paso 5: Haz una prueba completa con un jugador de test

Antes de abrir la matrícula real:

• Crea un jugador de prueba
• Accede al portal de matrícula
• Completa todo el proceso incluyendo el pago con Stripe
• Usa una tarjeta de prueba de Stripe (4242 4242 4242 4242)
• Verifica que el pago se procesa correctamente
• Comprueba que se genera el recibo
• Confirma que la matrícula queda como pagada

Paso 6: Realiza una prueba con pago real pequeño

Como prueba final:

• Haz un pago real de un importe pequeño (1€)
• Verifica que llega el dinero a la cuenta del club
• Comprueba que las notificaciones funcionan
• Confirma que todo el flujo es correcto de principio a fin

⚠️ Problemas comunes

Problemas frecuentes

El formulario Stripe no aparece en el portal

• Revisa que la conexión Stripe está activa
• Verifica que configuraste pago online para la matrícula
• Comprueba que hay productos y precios creados
• Confirma que estás en modo producción

El pago falla en pruebas

• Verifica que estás usando tarjetas de prueba correctas si es modo test
• Comprueba que el producto y precio están bien configurados
• Revisa que la cuenta Stripe no tiene limitaciones
• Confirma que las webhooks están funcionando

No se confirma el pago después de realizado

• Puede haber un problema con las webhooks
• Verifica que las URLs de webhook son correctas
• Comprueba que no hay errores en los logs de Stripe
• Revisa que el backend está procesando las notificaciones

Los productos no aparecen o no son correctos

• Verifica en el dashboard de Stripe que los productos existen
• Comprueba que tienen precios asociados activos
• Confirma que están en la moneda correcta
• Revisa que el sistema está sincronizado con Stripe

Estás en modo test y quieres pasar a producción

• Cambia las claves de API de test a producción
• Crea los productos en el entorno de producción
• Verifica la cuenta del club en Stripe (puede requerir documentación)
• Haz pruebas con pagos reales pequeños antes de abrir

💡 Consejos

Recomendaciones

Preparación antes de conectar Stripe

• Ten a mano los datos bancarios del club para verificación
• Prepara documentación que Stripe puede solicitar (NIF, estatutos, etc.)
• Revisa que el club tiene capacidad legal para operar cuenta Stripe
• Define quién tendrá acceso al dashboard de Stripe

Conexión segura

• Usa la integración OAuth oficial, nunca compartas claves API directamente
• Protege el acceso a las claves
• No uses claves de producción en entornos de desarrollo
• Configura alertas de Stripe para movimientos sospechosos

Productos y precios en Stripe

• Nombre claro: "Matrícula Benjamín 2024/25"
• Descripción que las familias entiendan
• Precio en céntimos (5000 = 50.00 EUR)
• Marca si es pago único o recurrente
• Asocia cada producto a la categoría o año correspondiente

Modos test vs. producción

• Modo test: Para pruebas, usa tarjetas de prueba, no se cobra dinero real
• Modo producción: Para operación real, cobra dinero real
• NUNCA mezcles claves de test y producción
• Documenta claramente cuándo pasaste a producción

Tarjetas de prueba de Stripe

• Éxito: 4242 4242 4242 4242
• Requiere autenticación: 4000 0027 6000 3184
• Fallo genérico: 4000 0000 0000 0002
• Saldo insuficiente: 4000 0000 0000 9995
• Usa cualquier fecha futura y cualquier CVV

Webhooks críticas

• payment_intent.succeeded: Pago completado
• payment_intent.failed: Pago fallido
• charge.refunded: Reembolso procesado
• Verifica que todas están configuradas correctamente
• Prueba que el sistema las recibe y procesa

Gestión de errores

• Define qué hacer cuando un pago falla
• Cómo comunicar a las familias los errores
• Proceso de reintento para pagos fallidos
• Soporte para familias con problemas de pago

Recibos y comprobantes

• Stripe genera recibos automáticamente
• Configura si quieres recibos personalizados del club
• Verifica que las familias los reciben por email
• Guarda historial de todos los pagos para referencia

Seguridad y cumplimiento

• Stripe es PCI-DSS compliant, tú no manejas datos de tarjetas
• El club no ve los números completos de tarjeta
• Cumple con regulaciones de protección de datos
• Implementa autenticación 3D Secure cuando sea necesario

Costes de Stripe

• Comisiones habituales en Europa: ~1.5% + 0.25€ por transacción
• Domiciliación SEPA: suele ser más económica
• Sin costes de mantenimiento mensual
• Evalúa si repercutes costes a familias o los asume el club

Soporte y resolución de incidencias

• Ten acceso al dashboard de Stripe para consultas
• Documenta cómo resolver pagos duplicados
• Define proceso para reembolsos si son necesarios
• Mantén comunicación fluida con Stripe support si hay problemas

Pruebas exhaustivas requeridas

• Pago exitoso de matrícula completa
• Pago fallido y gestión del error
• Cancelación a mitad del proceso
• Configuración de método automático para cuotas
• Generación y descarga de recibos
• Notificaciones email funcionando
• Sincronización de estados con el sistema