Índice
¿Qué es esta integración?
La integración con Stripe conecta Golfmanager con la pasarela de pago Stripe. Es una de las integraciones de pago más completas: permite cobros online con tarjeta, guardar la tarjeta del cliente para futuros pagos, verificación 3D Secure, pago presencial con datáfono (Stripe Terminal) y devoluciones. Además, admite cuentas conectadas (Stripe Connect).
Una pasarela de pago es el servicio que conecta tu negocio con los bancos para cobrar con tarjeta de forma segura. 3D Secure es el paso de verificación adicional (por ejemplo, una confirmación en la app del banco) que añade seguridad al pago.
¿Qué problema resuelve?
Cobra por todos los canales con una sola pasarela: online, TPV presencial y con tarjeta guardada.
Agiliza al cliente habitual: puede pagar con su tarjeta guardada sin volver a teclearla.
Mayor seguridad: el formulario de tarjeta lo gestiona Stripe (con 3D Secure); los datos no pasan por Golfmanager.
Devoluciones desde Golfmanager, sin entrar en el panel de Stripe.
Modalidades de pago que ofrece
Modalidad | Para qué sirve |
Pago online | El cliente paga con tarjeta al reservar o comprar online (también Apple Pay / Google Pay si su dispositivo lo permite) |
Tarjeta guardada | Cobrar con una tarjeta que el cliente guardó previamente |
Pago presencial (Stripe Terminal) | Cobrar en el TPV con un datáfono de Stripe |
Devolución | Reembolsar (total o parcial) una venta cobrada con Stripe |
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta el checkout y el TPV de Golfmanager con Stripe, en tiempo real:
En el pago online, el cliente introduce la tarjeta en el entorno seguro de Stripe y, si procede, completa el 3D Secure.
En el pago presencial, Golfmanager envía el cobro al datáfono y recibe el resultado.
Si se aprueba, la venta queda marcada como pagada. Para devolver, Golfmanager pide a Stripe el reembolso.
🔒 Seguridad: los datos de la tarjeta se gestionan en Stripe (PCI). Si guardas la tarjeta del cliente, Golfmanager almacena una referencia segura (token cifrado), nunca el número completo.
Requisitos previos (antes de activar la integración)
Tener una cuenta de Stripe.
Tener el módulo Stripe instalado, junto con el módulo de facturación.
Las claves de Stripe (pública y secreta), de prueba y de producción.
Para el cobro presencial, un datáfono compatible con Stripe Terminal.
Permisos de facturación para configurar.
Cómo se configura (paso a paso)
Paso 1 — Pago online
Accede a Golfmanager con un usuario con permiso de facturación.
Entra en Configuración > Stripe.
Introduce las claves pública y secreta, de prueba y de producción.
Indica la moneda (por defecto EUR) y deja el modo de producción desactivado para empezar con pruebas.
(Opcional) Activa el 3D Secure y revisa la opción "Evitar redirecciones".
Guarda los cambios.
Paso 2 — Pago presencial (Stripe Terminal)
Entra en la configuración de Stripe presencial.
Introduce las claves secretas (prueba y producción), la moneda y el modo de producción.
Conecta tu datáfono de Stripe Terminal.
Guarda los cambios.
Paso 3 — Cuenta conectada (opcional, Stripe Connect)
Si tu caso usa Stripe Connect, activa "Es una cuenta conectada" e indica la comisión de plataforma.
Completa el proceso de alta (onboarding) que ofrece Stripe.
⚠️ Recomendación: empieza con el modo de producción desactivado y haz un pago de prueba (Stripe ofrece tarjetas de test, por ejemplo 4242 4242 4242 4242); actívalo solo cuando todo funcione. Las claves secretas se guardan cifradas.
Explicación de cada campo
A continuación se describe cada campo de la integración: dónde está, qué significa, su impacto en el sistema y un ejemplo de uso (qué ocurre cuando se utiliza y cómo se comporta el sistema).
A) Claves y entorno (Stripe online)
1. Claves pública y secreta (prueba y producción)
Descripción: las credenciales de tu cuenta de Stripe. La pública se usa en el formulario de tarjeta; la secreta (cifrada) en las llamadas seguras a Stripe. Hay un juego de prueba y otro de producción.
Impacto en el sistema: imprescindibles. Sin ellas no se puede cobrar.
Ejemplo de uso: copias las claves del panel de Stripe (las de prueba empiezan por pk_test/sk_test; las reales por pk_live/sk_live).
Qué ocurre cuando se utiliza: Golfmanager usa las claves del entorno activo para procesar cada pago.
Comportamiento del sistema: si faltan o son incorrectas, Stripe no aparece o el pago falla ("No hay configuración de Stripe").
2. Modo de producción
Descripción: indica si se cobra de verdad (producción) o en pruebas (test).
Impacto en el sistema: determina qué claves se usan (producción o prueba).
Ejemplo de uso: lo dejas desactivado mientras pruebas y lo activas al salir a real.
Qué ocurre cuando se utiliza: activado, los cobros son reales; desactivado, son de prueba.
Comportamiento del sistema: si está mal puesto, podrías cobrar de verdad en una prueba o no cobrar en real.
3. Moneda
Descripción: la divisa de los cobros.
Impacto en el sistema: normalmente EUR por defecto.
Ejemplo de uso: la dejas en EUR salvo que cobres en otra divisa.
Qué ocurre cuando se utiliza: los importes se procesan en esa moneda.
Comportamiento del sistema: debe coincidir con la divisa de tu cuenta de Stripe.
B) Opciones de pago online
3D Secure: activa la verificación adicional del banco (SCA). Impacto: más seguridad; el cliente puede tener que confirmar el pago. Comportamiento: si está activo, Stripe pide la verificación cuando procede.
Evitar redirecciones: intenta completar el pago dentro de la propia pantalla, sin saltar a otra página. Impacto: experiencia de pago más fluida. Comportamiento: viene activado por defecto.
C) Cuenta conectada (Stripe Connect)
Es una cuenta conectada: activa el modelo Stripe Connect (plataforma + cuenta conectada). Impacto: cambia cómo se cobra y se liquida. Comportamiento: solo aplica si tu caso usa este modelo.
Comisión de plataforma: el porcentaje que se descuenta de cada cobro en el modelo de cuenta conectada. Impacto: se aplica a cada transacción. Comportamiento: solo tiene efecto con cuentas conectadas.
D) Stripe presencial (Terminal)
Claves secretas (prueba y producción), moneda y modo de producción: equivalentes a las del pago online, pero para el cobro con datáfono. Impacto: imprescindibles para el pago presencial. Comportamiento: se guardan cifradas; el modo de producción decide si el datáfono cobra de verdad.
Datáfono (lector): el dispositivo de Stripe Terminal que se conecta. Impacto: es donde el cliente presenta la tarjeta. Comportamiento: debe estar dado de alta y disponible para poder cobrar.
E) Tarjeta guardada y transacciones
Tarjeta guardada (en la ficha del cliente): marca, últimos dígitos, caducidad, si soporta 3D Secure, si es la predeterminada y si está validada. Impacto: permite cobrar sin volver a teclear la tarjeta. Comportamiento: Golfmanager guarda un token cifrado, no el número; solo puede haber una tarjeta predeterminada por cliente.
Transacción de Stripe: cada pago o devolución, con su tipo (pago/devolución), resultado (éxito o error), importe, importe devuelto e identificador de Stripe. Impacto: es el registro y la trazabilidad de cada cobro. Comportamiento: es de solo lectura; se consulta para diagnosticar.
Cómo se usa en el día a día
Pago online y tarjeta guardada
El cliente elige Stripe al pagar e introduce su tarjeta en el entorno seguro de Stripe.
Si lo permite, puede guardar la tarjeta para próximos pagos (debe estar identificado); completa el 3D Secure si su banco lo pide.
Al aprobarse, la venta queda marcada como pagada.
Pago presencial en el TPV
En el TPV, selecciona "Stripe presencial"; el cobro se envía al datáfono y el cliente presenta la tarjeta.
Devoluciones
Para devolver un pago de Stripe, cancela el pago desde Golfmanager: el sistema solicita a Stripe el reembolso (total o parcial) y lo registra.
Transacciones y tarjetas guardadas
Transacciones de Stripe: el registro de todos los pagos y devoluciones, con su resultado. Es la primera pantalla a revisar cuando un cobro no se ha completado.
Tarjetas de Stripe: las tarjetas guardadas. En la ficha de cada cliente hay una pestaña "Tarjetas" con sus tarjetas.
Cuentas conectadas (Stripe Connect)
Stripe admite cuentas conectadas (Stripe Connect): un modelo en el que Golfmanager actúa como plataforma y el club se da de alta como cuenta conectada mediante un proceso guiado de alta (onboarding). En este modelo puede aplicarse una comisión de plataforma sobre los cobros.
Si tu caso no usa este modelo, simplemente configuras tus propias claves de Stripe y cobras directamente.
Limitaciones a tener en cuenta
Necesitas una cuenta de Stripe y sus claves.
El cobro presencial requiere un datáfono de Stripe Terminal.
Guardar tarjetas depende de la configuración, de que el cliente esté identificado y de que lo acepte.
Las claves de prueba y producción son distintas: recuerda activar el modo de producción para cobrar de verdad.
Depende de Stripe: si el servicio no está disponible, no se pueden procesar pagos en ese momento.
Preguntas frecuentes
No aparece Stripe al pagar.
Suele faltar alguna clave o el método no está activo. Aparece "No hay configuración de Stripe". Revisa las claves del entorno activo (prueba o producción) en Configuración > Stripe.
El pago se rechaza.
La tarjeta puede estar denegada o el 3D Secure no se completó ("Autenticación fallida" / "El pago ha fallado"). Revisa el detalle en Transacciones; el cliente puede reintentar o probar otra tarjeta.
El pago presencial no se completa.
El datáfono no responde o falta la clave de Stripe presencial. Comprueba que el datáfono está conectado y disponible y que las claves están bien.
Cobra de verdad en una prueba (o no cobra en real).
El modo de producción está mal puesto. Actívalo para cobrar de verdad y desactívalo para hacer pruebas; recuerda que las claves de prueba y producción son distintas.
Aparece que "la tarjeta guardada ya no está disponible en Stripe".
Esa tarjeta se eliminó en Stripe. El cliente debe volver a guardar la tarjeta o pagar con otra.
Me dice "ya pagado" al reintentar un cobro.
Ese cobro ya se había completado. No se vuelve a cobrar; revisa la venta y su pago en Transacciones.
¿El cliente debe estar identificado para guardar la tarjeta?
Sí. Para guardar una tarjeta el cliente tiene que haber iniciado sesión ("Debes iniciar sesión para guardar tarjetas").
¿Cómo hago una devolución?
Cancela el pago desde Golfmanager: el sistema pide a Stripe el reembolso y lo registra. Admite devoluciones totales o parciales.
Al devolver me dice que debo anular antes el pago original.
La devolución se hace sobre el pago original. Sigue el flujo de anulación/abono indicado y el reembolso se enviará a Stripe.
¿Dónde reviso los cobros y devoluciones?
En la pantalla de Transacciones de Stripe: cada operación queda con su resultado y, si hubo error, el detalle.
¿Es seguro? ¿Dónde se guardan los datos de la tarjeta?
La seguridad de la tarjeta (PCI) la gestiona Stripe; los datos no pasan por Golfmanager. Si se guarda la tarjeta, Golfmanager almacena solo una referencia cifrada (token), nunca el número completo.
¿Qué es el 3D Secure y cuándo aparece?
Es una verificación extra del banco (por ejemplo, confirmar en su app). Si está activo, Stripe la pide cuando el banco o la normativa lo requieren. En pruebas, hay tarjetas de test que simulan el 3D Secure.
¿Qué métodos de pago admite?
Tarjetas (Visa, Mastercard, American Express…) y, si el dispositivo del cliente lo permite, Apple Pay / Google Pay. El pago presencial es con datáfono. (El método iDEAL se gestiona en su propia integración.)
¿En qué moneda se cobra?
En euros por defecto, salvo que configures otra divisa (debe coincidir con tu cuenta de Stripe).
¿Qué es la comisión de plataforma?
Es un porcentaje que se descuenta de cada cobro solo en el modelo de cuentas conectadas (Stripe Connect). Si no usas Connect, no aplica.
¿Puede cobrarse una suscripción automáticamente?
Sí. Con la tarjeta guardada, los cobros recurrentes pueden hacerse de forma automática sin que el cliente esté presente.
¿Cómo pruebo antes de cobrar de verdad?
Con el modo de producción desactivado y las tarjetas de prueba de Stripe (por ejemplo, 4242 4242 4242 4242). Activa producción solo cuando todo funcione.
Buenas prácticas recomendadas
Prueba primero en modo test con las tarjetas de prueba de Stripe antes de operar en real.
Activa el 3D Secure para reforzar la seguridad de los pagos.
Activa "guardar tarjetas" si quieres ofrecer pagos rápidos a clientes habituales.
Ante un pago fallido, revisa primero Transacciones: el detalle del error suele indicar la causa.