Índice
¿Qué es esta integración?
La integración con iDEAL permite que tus clientes paguen online con iDEAL, el método de pago más usado en los Países Bajos, en el que el cliente paga directamente desde su banco. El cobro se procesa a través de Stripe.
Es ideal para clubes con clientela neerlandesa que prefiere pagar por transferencia bancaria instantánea en lugar de con tarjeta.
iDEAL es un sistema de pago neerlandés: el cliente elige su banco y autoriza el pago desde su banca online. Stripe es la pasarela que procesa la operación; necesitas una cuenta de Stripe con iDEAL activado. Las operaciones se hacen en euros (EUR).
¿Qué problema resuelve?
Ofrece el método de pago preferido por los clientes de los Países Bajos.
Cobro online seguro: el pago se autoriza en el banco del cliente; los datos bancarios no pasan por Golfmanager.
Confirmación automática: al completarse el pago, la venta queda marcada como pagada.
Devoluciones desde Golfmanager, sin entrar en el panel de Stripe.
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta el checkout (pago) de Golfmanager con Stripe (que gestiona iDEAL), en tiempo real:
El cliente elige iDEAL y autoriza el pago en su banco.
Stripe procesa el pago y avisa a Golfmanager del resultado mediante un aviso automático (webhook): pagado, fallido o cancelado.
Si el pago se completa, la venta queda marcada como pagada.
Para devolver, Golfmanager pide a Stripe que reembolse el importe.
¿Qué información se intercambia?
Información | Dirección | Para qué |
Importe y moneda | Golfmanager → Stripe | Iniciar el pago con iDEAL |
Resultado del pago (pagado / fallido / cancelado) | Stripe → Golfmanager | Confirmar el cobro y dejar registro |
Solicitud de devolución | Golfmanager → Stripe | Reembolsar al cliente |
🔒 Seguridad: el pago se autoriza en el banco del cliente a través de Stripe. Golfmanager no maneja datos bancarios; solo recibe el resultado de la operación.
Requisitos previos (antes de activar la integración)
Tener una cuenta de Stripe con el método de pago iDEAL activado.
Tener el módulo iDEAL (Stripe) instalado en tu Golfmanager, junto con el módulo de facturación.
Las claves de Stripe (pública y secreta), de prueba y de producción.
Configurar un webhook en Stripe para que avise a Golfmanager del resultado de los pagos (ver configuración).
Permisos de gestión de facturación para configurar.
Cómo se configura (paso a paso)
Paso 1 — Instalar el módulo
Instala el módulo iDEAL (Stripe). Después aparece la Configuración de Ideal Stripe y las Transacciones.
Paso 2 — Claves de Stripe y moneda
Ve a Configuración > Ideal Stripe.
Introduce la Moneda (normalmente
EUR).Introduce las claves de prueba (pública y secreta) de tu cuenta de Stripe.
Introduce también las claves de producción (pública y secreta).
Deja el Modo de producción desactivado para empezar a probar.
Guarda los cambios. Las claves secretas se guardan cifradas.
Paso 3 — Configurar el webhook en Stripe
En el panel de Stripe, crea un webhook que apunte a la dirección de tu Golfmanager terminada en
/stripeIdeal/callback.json.Suscríbelo a estos eventos:
payment_intent.succeeded(pago completado),payment_intent.payment_failed(pago fallido) ypayment_intent.canceled(pago cancelado).
⚠️ El webhook es imprescindible: es lo que permite que Golfmanager se entere de que el pago se ha completado y marque la venta como pagada. Sin él, los pagos quedarían sin confirmar.
Paso 4 — Probar y activar producción
Con el modo de producción desactivado, haz un pago de prueba y comprueba en Transacciones que aparece como correcto.
Cuando todo funcione, vuelve a la configuración y activa el Modo de producción. A partir de ese momento, los pagos son reales.
Detalle de cada campo de configuración
A continuación se explica cada campo de Configuración > Ideal Stripe: qué es, cómo afecta al sistema, cómo se comporta y un ejemplo de uso. Las claves secretas se guardan cifradas.
Moneda
Nombre del campo: Moneda.
Descripción: la moneda en la que se cobran los pagos.
Impacto en el sistema: se envía a Stripe en cada pago. iDEAL funciona en euros.
Comportamiento del sistema: el valor habitual es
EUR; con iDEAL no tiene sentido otra moneda.Ejemplo de uso / qué ocurre: dejas
EURy todos los cobros se hacen en euros.
Modo de producción
Nombre del campo: Modo de producción. Es un interruptor (activado/desactivado, por defecto desactivado).
Descripción: decide si los pagos son reales o de prueba.
Impacto en el sistema: activado, usa las claves de producción y cobra de verdad; desactivado, usa las claves de prueba.
Comportamiento del sistema: según el modo, se usan unas claves u otras; deben estar rellenas las del modo activo.
Ejemplo de uso / qué ocurre: lo dejas desactivado mientras pruebas y lo activas cuando vas a cobrar de verdad.
Clave pública de prueba
Nombre del campo: Clave pública de prueba (Public Test Key).
Descripción: la clave pública de Stripe para el entorno de pruebas.
Impacto en el sistema: es la que usa el formulario de pago en el navegador del cliente, en pruebas.
Comportamiento del sistema: se usa cuando el modo de producción está desactivado.
Ejemplo de uso / qué ocurre: la copias del panel de Stripe (claves de test) y la pegas aquí.
Clave secreta de prueba
Nombre del campo: Clave secreta de prueba (Private Test Key).
Descripción: la clave secreta de Stripe para el entorno de pruebas.
Impacto en el sistema: es con la que Golfmanager se comunica con Stripe (crear el pago, devoluciones) en pruebas.
Comportamiento del sistema: nunca se envía al navegador; se guarda cifrada.
Ejemplo de uso / qué ocurre: la copias del panel de Stripe (claves de test) y la pegas aquí.
Clave pública de producción
Nombre del campo: Clave pública de producción (Public Production Key).
Descripción: la clave pública de Stripe para cobros reales.
Impacto en el sistema: inicializa el formulario de pago cuando operas en producción.
Comportamiento del sistema: se usa cuando el modo de producción está activado.
Ejemplo de uso / qué ocurre: la copias del panel de Stripe (claves en vivo) y la pegas aquí.
Clave secreta de producción
Nombre del campo: Clave secreta de producción (Production Secret Key).
Descripción: la clave secreta de Stripe para cobros reales.
Impacto en el sistema: es con la que Golfmanager se comunica con Stripe en producción (cobros y devoluciones).
Comportamiento del sistema: nunca se envía al navegador; se guarda cifrada.
Ejemplo de uso / qué ocurre: la copias del panel de Stripe (claves en vivo) y la pegas aquí.
Cómo se usa en el día a día
Pago online del cliente
El cliente realiza una reserva o una compra y va a pagar.
Selecciona iDEAL como método de pago, introduce su nombre y acepta las condiciones.
Elige su banco y autoriza el pago desde su banca online.
Al volver, ve una pantalla que dice "Validando tu pago, por favor espera…" mientras Golfmanager recibe la confirmación.
Cuando se confirma, la venta queda marcada como pagada y el cliente ve "Pago confirmado".
Devoluciones
Para devolver un pago de iDEAL, cancela el pago original desde Golfmanager: el sistema pide a Stripe el reembolso y lo registra. Además, si por algún motivo una venta no se pudiera confirmar tras un pago correcto, Golfmanager realiza la devolución automáticamente para no dejar un cobro sin venta.
Consultar las transacciones
En Facturación > Transacciones de Ideal Stripe verás todos los pagos y devoluciones. Cada registro muestra:
El cliente y el importe.
El tipo (pago o devolución) y el importe devuelto, si lo hay.
Si fue correcto o fallido y el detalle del error si lo hubo.
Es la primera pantalla a revisar cuando un pago o una devolución no han salido como esperabas. (Requiere permisos de administrador de sistema.)
Limitaciones a tener en cuenta
iDEAL es de los Países Bajos: está pensado para clientes con cuenta en un banco neerlandés y para pagos en euros.
Es para pagos online del cliente (reservas, bonos y tienda), no para el TPV físico.
Requiere una cuenta de Stripe con iDEAL activado y el webhook configurado.
Las claves de prueba y producción son distintas: recuerda activar el modo de producción para cobrar de verdad.
El pago puede tardar unos instantes en confirmarse: por eso aparece la pantalla de "Validando tu pago…". Si el banco tarda demasiado, puede que el cliente vea "Pago no confirmado" aunque el pago acabe llegando; revísalo en Transacciones.
Si el cliente abandona en el banco, el pago no se completa y la venta queda sin pagar. No se le cobra nada.
Depende de Stripe y del banco del cliente: si alguno no está disponible, el pago no se puede completar en ese momento.
Preguntas frecuentes
¿Qué es iDEAL y por qué pasa por Stripe?
iDEAL es el método de pago más usado en los Países Bajos: el cliente paga desde su banca online. Stripe es la pasarela que procesa la operación; por eso necesitas una cuenta de Stripe con iDEAL activado.
¿En qué moneda se cobra?
En euros (EUR). iDEAL funciona en euros; la moneda se configura en Configuración > Ideal Stripe.
¿De dónde saco las claves de Stripe?
Del panel de Stripe. Tienes claves de prueba (test) y de producción (en vivo), cada una con su clave pública y su clave secreta. Se rellenan todas en la configuración.
¿Por qué hay que configurar un webhook?
Porque iDEAL confirma el pago de forma asíncrona: el webhook es el aviso que Stripe envía a Golfmanager cuando el pago se completa, falla o se cancela. Sin webhook, Golfmanager no se entera de que el pago se hizo y la venta no se marca como pagada.
¿A qué dirección apunta el webhook y qué eventos debe llevar?
A tu Golfmanager, terminando en /stripeIdeal/callback.json, suscrito a payment_intent.succeeded, payment_intent.payment_failed y payment_intent.canceled.
El cliente paga pero la venta no se marca como pagada. ¿Qué reviso?
Casi siempre es el webhook: que no esté configurado, que la dirección sea incorrecta o que no esté suscrito a los eventos. Revísalo en el panel de Stripe y comprueba que llega a /stripeIdeal/callback.json.
El cliente no ve iDEAL al pagar. ¿Por qué?
Porque el módulo no está configurado o faltan las claves del modo activo. Comprueba las claves en Configuración > Ideal Stripe (las de prueba o las de producción, según el modo).
El pago falla o se cancela. ¿Qué hago?
Normalmente el cliente no completó la autorización en su banco. Puede reintentar el pago. Revisa el detalle en Transacciones; verás el mensaje del error (por ejemplo, "pago fallido").
El cliente ve "Pago no confirmado" pero creo que sí pagó. ¿Qué pasó?
A veces el banco tarda más de lo que dura la pantalla de validación y el cliente ve "Pago no confirmado" aunque el pago acabe llegando por el webhook. Comprueba en Transacciones si el pago entró: si está correcto, la venta queda pagada.
¿Qué pasa si el cliente abandona en el banco?
El pago no se completa y la venta queda sin pagar. No se le cobra nada. El cliente puede volver a intentarlo.
¿Cómo hago una devolución?
Cancela el pago original desde Golfmanager: el sistema pide el reembolso a Stripe y lo registra. La devolución siempre se hace sobre el pago original.
¿Qué es la "devolución automática"?
Si un pago llega correctamente pero, por algún motivo, la venta no se puede confirmar, Golfmanager devuelve el importe automáticamente a Stripe para no dejar un cobro sin su venta. Lo verás reflejado en Transacciones.
Sale "Debes anular el pago original" al intentar devolver. ¿Qué pasa?
Una devolución necesita un pago de referencia. Asegúrate de devolver sobre la operación de pago original; no se puede reembolsar sin ella.
Cobra de verdad en una prueba (o no cobra en real). ¿Qué reviso?
El Modo de producción está mal puesto, o has mezclado claves de prueba y de producción. Ajusta el modo y verifica que las claves correspondan al modo activo.
¿En qué se pueden usar los pagos con iDEAL?
En lo que el cliente paga online desde el portal: reservas, bonos y compras de la tienda (recargas de saldo incluidas).
¿Sirve para el TPV físico de recepción?
No. Esta integración es para pagos online del cliente, no para el datáfono del TPV.
¿Se puede usar iDEAL para cobros recurrentes de cuotas?
iDEAL es un pago puntual: el cliente autoriza un pago concreto en su banco. No está pensado como medio para domiciliaciones automáticas recurrentes.
¿Dónde veo el estado de un pago o una devolución?
En Facturación > Transacciones de Ideal Stripe: ahí está el cliente, el importe, si fue correcto o fallido, el tipo y el detalle del error si lo hubo.
¿Las claves están seguras?
Sí. Las claves secretas (de prueba y de producción) se guardan cifradas, y el pago se autoriza en el banco del cliente sin pasar por Golfmanager. Aun así, no compartas las claves.
¿Qué permisos necesito para configurar la integración?
Permisos de gestión de facturación para la configuración, y de administrador de sistema para ver las transacciones.
¿Qué hago antes de empezar a cobrar de verdad?
Configura y prueba el webhook, haz un pago de prueba en modo test validándolo en Transacciones, y solo entonces activa el Modo de producción con las claves en vivo.
Buenas prácticas recomendadas
Configura y prueba el webhook antes de operar en real: es lo que confirma los pagos.
Prueba primero en modo test y pasa a producción cuando todo funcione.
Guarda bien las claves de producción y no las compartas; las claves secretas se almacenan cifradas.
Configura la moneda en EUR, que es la de iDEAL.
Ante un pago fallido o "no confirmado", revisa primero Transacciones: el detalle suele aclarar qué pasó.