CompteamDocumentaciónCómo configurar Stripe

Cómo configurar Stripe

Conecta Stripe en Proveedores de pago, añade el secreto de firma del webhook, explora tu catálogo de Stripe y vincula precios de Stripe a planes de membresía, equipamiento y ofertas de entrenamiento.

  1. 1

    Antes de empezar

    Usa esta guía si quieres que tu sede acepte pagos con Stripe para:

    • planes de membresía
    • productos de equipamiento
    • ofertas de entrenamiento

    Necesitas:

    • una cuenta de admin de sede en CompTeam
    • una cuenta de Stripe a la que puedas acceder
    • una sede con la moneda de facturación ya configurada

    CompTeam ahora usa una configuración central de Stripe en Proveedores de pago. Conectas Stripe una vez y luego reutilizas el mismo catálogo de Stripe en el resto de la app.

  2. 2

    Abrir Facturación y conectar Stripe

    Ve a Proveedores de pago en la barra lateral y localiza la tarjeta Cuenta Stripe de la sede.

    Haz clic en Conectar Stripe. CompTeam te enviará al flujo OAuth seguro de Stripe. En Stripe:

    1. Inicia sesión en la cuenta de Stripe que debe usar esta sede.
    2. Revisa la solicitud de acceso.
    3. Aprueba la conexión.

    Después de que Stripe te redirija de vuelta a CompTeam, la página de Proveedores de pago debería mostrar:

    • el nombre de la cuenta Stripe conectada
    • el id de la cuenta (acct_...)
    • la vista previa del catálogo de la sede

    Si prefieres o necesitas un flujo alternativo, la misma tarjeta de Proveedores de pago sigue permitiendo guardar manualmente una clave secreta de Stripe.

  3. 3

    Añadir el secreto de firma del webhook

    Todavía en Proveedores de pago, añade tu secreto de firma del webhook en la tarjeta de Stripe.

    CompTeam te muestra la URL del webhook específica de la sede que debes usar en Stripe.

    En tu panel de Stripe:

    1. Crea o edita un endpoint de webhook.
    2. Pega la URL del webhook que muestra CompTeam.
    3. Copia el secreto de firma generado (whsec_...).
    4. Pega ese secreto en CompTeam y haz clic en Guardar.

    Esto permite a CompTeam verificar que los eventos entrantes realmente vienen de Stripe antes de actualizar los pagos dentro de tu sede.

  4. 4

    Explorar tu catálogo de Stripe

    Una vez que Stripe esté conectado, la página de Proveedores de pago puede cargar los productos y precios de Stripe de tu sede.

    Usa la búsqueda del catálogo para inspeccionar:

    • nombre del producto e id del producto
    • si un producto o precio está activo
    • precios puntuales frente a recurrentes
    • importe, moneda e intervalo

    CompTeam trata Stripe como la fuente de verdad para los precios vinculados. Eso significa que cuando vinculas un precio de Stripe a un registro de CompTeam, el importe y la moneda de Stripe tienen prioridad sobre los campos de precio manuales locales.

  5. 5

    Vincular precios de Stripe a planes, equipamiento y entrenamientos

    Después de configurar la conexión, ve a la página de administración correspondiente y usa Elegir de Stripe:

    Planes de membresía

    Ve a Planes de membresía y crea o edita un plan.

    • Usa Elegir de Stripe junto a Stripe Price ID para el precio recurrente principal.
    • Usa Elegir de Stripe junto a Stripe Signup Fee Price ID si también cobras una cuota de inscripción puntual.

    Equipamiento

    Ve a Equipamiento, abre un producto y usa Elegir de Stripe para adjuntar un precio de Stripe puntual.

    Ofertas de entrenamiento

    Ve a Administración de ofertas de entrenamiento y usa Elegir de Stripe para adjuntar un precio de Stripe puntual a una clase suelta, clase privada o seminario.

    CompTeam valida que el precio seleccionado pertenezca a la cuenta Stripe conectada actualmente, por lo que no puedes vincular por accidente un precio de Stripe de otra sede.

  6. 6

    Cómo comprobar que todo funciona

    Haz una comprobación rápida como admin de sede después de la configuración:

    1. Vuelve a Proveedores de pago y confirma que el id de la cuenta Stripe es visible.
    2. Confirma que el catálogo carga al menos un producto o un precio.
    3. Vincula un elemento de prueba:
      • un plan de membresía recurrente, o
      • un producto de equipamiento, o
      • una oferta de entrenamiento
    4. Reabre ese registro y comprueba que el precio vinculado a Stripe sigue apareciendo.

    Si alguna vez necesitas cambiar de cuenta Stripe, usa Desconectar en Proveedores de pago y vuelve a conectar la cuenta correcta. Los ids vinculados permanecen guardados, pero CompTeam solo puede validarlos e hidratarlos correctamente contra la cuenta que esté conectada en ese momento a la sede.

    Para el cobro recurrente de miembros, continúa con la guía de Débito directo SEPA si tu sede también usa cobro bancario basado en facturas. Stripe y SEPA pueden convivir en la misma sede.