Índice
¿Qué es esta integración?
La integración con Redsys conecta Golfmanager con la pasarela de pago Redsys, la más utilizada en España (la usan la mayoría de los bancos). Permite cobrar online con tarjeta, guardar la tarjeta del cliente para futuros pagos, cobrar de forma presencial con datáfono en el TPV y realizar devoluciones.
Una pasarela de pago es el servicio que conecta tu negocio con los bancos para cobrar con tarjeta de forma segura. Redsys es la pasarela estándar en España; tu banco te facilita un "comercio" (TPV virtual) y unas claves para usarla.
¿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: los datos de la tarjeta los gestiona Redsys; no se guardan en Golfmanager.
Devoluciones desde Golfmanager, sin entrar en el panel de Redsys.
Modalidades de pago que ofrece
Modalidad | Para qué sirve |
Pago online | El cliente paga con tarjeta al reservar o comprar online |
Tarjeta guardada | Cobrar con una tarjeta que el cliente guardó previamente |
Pago presencial (datáfono) | Cobrar en el TPV con el datáfono de Redsys |
Devolución | Reembolsar una venta cobrada con Redsys |
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta el checkout y el TPV de Golfmanager con Redsys, en tiempo real:
En el pago online, el cliente introduce la tarjeta en el entorno seguro de Redsys; Redsys autoriza y avisa del resultado.
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 Redsys el reembolso.
🔒 Seguridad: los datos de la tarjeta se gestionan en Redsys. Si guardas la tarjeta del cliente, Golfmanager almacena una referencia segura (token) y los últimos dígitos, nunca el número completo.
Requisitos previos (antes de activar la integración)
Tener un comercio Redsys (TPV virtual) contratado con tu banco.
Tener el módulo Redsys instalado, junto con el módulo de facturación.
Las claves de Redsys (de prueba y de producción) que te facilita tu banco.
Para el cobro presencial, el código de comercio y la clave de firma, y un datáfono Redsys.
Permisos de facturación para configurar.
Darse de alta con el banco (proceso previo)
Antes de configurar Golfmanager, debes contratar la pasarela Redsys con tu banco. El proceso habitual es:
Contacta con tu banco y solicita una pasarela de pago Redsys para recibir pagos online.
Facilítales los datos del comercio que te pidan:
Nombre: el de tu empresa.
URL del comercio: la dirección de tu web de reservas (consumer), por ejemplo
https://eu.golfmanager.com/tutenant(sustituye por el nombre de tu tenant).Email del comercio y Estado: Activo.
Indica estos parámetros de la pasarela: Notificación online: HTTP, Sincronización: Síncrona SOAP, Enviar parámetros en las URLs: No.
Recibirás un correo con acceso en Modo Prueba al portal de banca privada de Redsys, con los datos que necesitarás: Merchant Code (FUC), Terminal, Moneda (€ = 978), URL de test (normalmente
https://sis-t.redsys.es:25443/sis/realizarPago) y la contraseña de pruebas.Tras hacer las pruebas, escribe de nuevo a Redsys indicando que quieres pasar a Modo Real. Recibirás un segundo correo con los datos de producción.
ℹ️ El Merchant Code (FUC) es tu número de comercio y el Terminal identifica el TPV virtual dentro de ese comercio. Ambos te los facilita Redsys/tu banco.
Cómo se configura (paso a paso)
Ubicación: Menú Configuración > Facturación > Configuración de Redsys
Paso 1 — Pago online
Accede a Menú Configuración > Facturación > Configuración de Redsys.
Activa Notificación Síncrona SOAP.
Introduce la Moneda (978 para euros) y el Terminal (normalmente 1).
Introduce las claves de prueba (clave pública y clave privada de prueba) para validar primero en modo test.
Introduce las claves de producción (clave pública de producción y clave secreta de producción, ambas obligatorias).
Decide si activar Tokenizar tarjetas (no lo actives hasta que Redsys te lo confirme).
Opcional: activa Impedir al usuario eliminar sus tarjetas.
Cuando todo esté validado, activa Modo Producción.
Guarda los cambios.
Paso 2 — Pago presencial (datáfono)
En la sección Redsys presencial, introduce el código de comercio y la clave de firma.
Indica un email de notificación.
Empieza con el modo de producción desactivado, haz un pago de prueba y actívalo solo cuando funcione.
Guarda los cambios.
⚠️ Recomendación: empieza siempre con el modo de producción desactivado y realiza un pago de prueba; actívalo solo cuando todo funcione. Las claves secretas se guardan cifradas.
Los campos de configuración en detalle
A continuación se explica cada campo de la configuración de Redsys.
1) Modo Producción
• Nombre del campo: Modo Producción
• Descripción: Determina si los cobros se hacen en el entorno real (producción) o en el de pruebas (test).
• Impacto en el sistema: Con él activado se usan las claves de producción y los cobros son reales; desactivado, se usan las de prueba y no se cobra de verdad.
• Ejemplo de uso: lo dejas desactivado hasta validar, y lo activas al pasar a real.
Qué ocurre cuando se utiliza: al activarlo, los siguientes pagos cargan dinero real a las tarjetas.
Comportamiento del sistema: si está mal puesto, cobrarás de verdad en una prueba o no cobrarás en real.
2) Terminal
• Nombre del campo: Terminal
• Descripción: Número de terminal del TPV virtual dentro de tu comercio Redsys (normalmente 1).
• Impacto en el sistema: Debe coincidir con el terminal que te asignó Redsys.
• Ejemplo de uso: introduces 1 (el que indique tu email de Redsys).
Qué ocurre cuando se utiliza: los pagos se procesan contra ese terminal.
Comportamiento del sistema: un terminal incorrecto provoca el rechazo de los pagos.
3) Moneda
• Nombre del campo: Moneda
• Descripción: Código numérico de la divisa. El euro es 978.
• Impacto en el sistema: Define la divisa en la que se envían los cobros a Redsys.
• Ejemplo de uso: introduces 978 para euros.
Qué ocurre cuando se utiliza: los importes se cobran en esa divisa.
Comportamiento del sistema: una divisa incorrecta puede provocar rechazos.
4) Clave pública de producción
• Nombre del campo: Clave pública de producción (campo obligatorio)
• Descripción: Identificador público de tu comercio en el entorno real, facilitado por Redsys.
• Impacto en el sistema: Necesaria para operar en producción.
• Ejemplo de uso: la copias del segundo email de Redsys (Modo Real).
Qué ocurre cuando se utiliza: identifica tu comercio en los cobros reales.
Comportamiento del sistema: sin ella, no se puede cobrar en real.
5) Clave secreta de producción
• Nombre del campo: Clave secreta de producción (campo obligatorio)
• Descripción: Clave de firma secreta (SHA-256) del entorno real. Es información sensible y se guarda cifrada.
• Impacto en el sistema: Firma y valida cada operación con Redsys en producción.
• Ejemplo de uso: la pegas desde el portal de banca privada de Redsys.
Qué ocurre cuando se utiliza: garantiza que la comunicación con Redsys es auténtica.
Comportamiento del sistema: una clave incorrecta hace que Redsys rechace las operaciones por firma inválida.
6) Clave pública de prueba y Clave privada de prueba
• Nombre del campo: Clave pública de prueba / Clave privada de prueba
• Descripción: Las equivalentes a las de producción, pero para el entorno de pruebas.
• Impacto en el sistema: Permiten validar la integración sin cobrar dinero real.
• Ejemplo de uso: las usas con el Modo Producción desactivado.
Qué ocurre cuando se utiliza: los pagos se simulan en el entorno de test de Redsys.
Comportamiento del sistema: solo se usan cuando el Modo Producción está desactivado.
7) Notificación Síncrona SOAP
• Nombre del campo: Notificación Síncrona SOAP
• Descripción: Activa la confirmación inmediata del pago con Redsys.
• Impacto en el sistema: Permite rechazar pagos directamente si la confirmación falla (por ejemplo, al pagar una reserva que ya ha caducado).
• Ejemplo de uso: la activas para evitar pagos sobre reservas no válidas.
Qué ocurre cuando se utiliza: si la venta ya no es válida en el momento de confirmar, el pago se rechaza.
Comportamiento del sistema: añade una verificación en tiempo real antes de dar el pago por bueno.
8) Tokenizar tarjetas
• Nombre del campo: Tokenizar tarjetas (también "Pay with tokens")
• Descripción: Permite guardar la tarjeta del cliente como una referencia segura (token) para cobros futuros.
• Impacto en el sistema: Habilita las "Tarjetas Redsys" guardadas y el cobro con tarjeta guardada. No lo actives hasta que Redsys confirme que el servicio está habilitado.
• Ejemplo de uso: lo activas cuando Redsys te confirma el pago por referencia.
Qué ocurre cuando se utiliza: el cliente puede aceptar guardar su tarjeta y reutilizarla.
Comportamiento del sistema: Golfmanager guarda solo el token y los últimos dígitos, nunca el número completo.
9) Guardar tarjeta automáticamente
• Nombre del campo: Guardar tarjeta automáticamente ("Save credit card automatically")
• Descripción: Guarda la tarjeta tras un pago online (cuando el cliente lo consiente) sin pasos adicionales.
• Impacto en el sistema: Facilita tener tarjetas guardadas para cobrar después en el TPV.
• Ejemplo de uso: lo activas junto con la tokenización para clientes habituales.
Qué ocurre cuando se utiliza: la tarjeta del cliente queda disponible para cobros posteriores.
Comportamiento del sistema: requiere que la tokenización esté activa y que Redsys lo permita.
10) Impedir al usuario eliminar sus tarjetas
• Nombre del campo: Impedir al usuario eliminar sus tarjetas
• Descripción: Evita que el cliente borre por su cuenta las tarjetas guardadas.
• Impacto en el sistema: Útil cuando el club quiere asegurar el cobro de servicios recurrentes.
• Ejemplo de uso: lo activas si dependes de la tarjeta guardada para cuotas o no-shows.
Qué ocurre cuando se utiliza: el cliente no ve la opción de eliminar sus tarjetas.
Comportamiento del sistema: las tarjetas guardadas permanecen disponibles para el club.
11) Redsys presencial: Código de comercio y Clave de firma
• Nombre del campo: Código de comercio / Clave de firma (sección Redsys presencial)
• Descripción: Datos del comercio para el cobro con datáfono en el TPV.
• Impacto en el sistema: Permiten enviar los cobros al datáfono y validar las operaciones presenciales.
• Ejemplo de uso: los facilita tu banco para el TPV físico.
Qué ocurre cuando se utiliza: al cobrar en el TPV, el importe se envía al datáfono.
Comportamiento del sistema: datos incorrectos impiden completar el cobro presencial.
ℹ️ Nota: los nombres exactos pueden variar ligeramente según tu versión e idioma (por ejemplo, algunas opciones aparecen en inglés como "Pay with tokens" o "Save credit card automatically"). La función es la descrita.
Activar la tarjeta tokenizada para cobrar en TPV
Si quieres poder cobrar en el TPV con una tarjeta que el cliente guardó online (pago por referencia):
Solicita al Customer Service de Redsys que activen en tu comercio: el pago por referencia, la devolución de los 4 últimos dígitos de la tarjeta y el pago no seguro.
Cuando te confirmen que están activados, ve a Menú de Configuración > Redsys > General.
Activa Pay with tokens (pagar con tokens).
Activa Save credit card automatically (guardar tarjeta automáticamente).
Haz las pruebas oportunas para comprobar que funciona.
🔒 Importante: Golfmanager no guarda los datos de ninguna tarjeta; los guarda la pasarela de pago por seguridad. En el sistema solo se ven los 4 últimos dígitos para poder usarla en la tokenización, y siempre que el cliente, en la compra online, confirme que quiere guardarla para futuras compras.
Cómo se usa en el día a día
Pago online y tarjeta guardada
El cliente elige Redsys al pagar e introduce su tarjeta en el entorno seguro de Redsys.
Si lo permite, puede guardar la tarjeta para próximos pagos.
Al aprobarse, la venta queda marcada como pagada.
Pago presencial en el TPV
En el TPV, selecciona "Redsys presencial"; el cobro se envía al datáfono y el cliente presenta la tarjeta.
Devoluciones
Para devolver un pago de Redsys, cancela el pago desde Golfmanager: el sistema solicita a Redsys el reembolso y lo registra.
Transacciones y tarjetas guardadas
Transacciones de Redsys: 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 Redsys: las tarjetas guardadas. En la ficha de cada cliente hay una pestaña "Tarjetas Redsys" con sus tarjetas (últimos dígitos y cuál es la principal).
Limitaciones a tener en cuenta
Necesitas un comercio Redsys contratado con tu banco y sus claves.
El cobro presencial requiere un datáfono Redsys y su configuración (código de comercio y clave de firma).
Guardar tarjetas depende de la configuración y de que el cliente lo acepte; además, Redsys debe tener activados los servicios de pago por referencia.
Las claves de prueba y producción son distintas: recuerda activar el modo de producción para cobrar de verdad.
Depende de Redsys: si el servicio no está disponible, no se pueden procesar pagos en ese momento.
Preguntas frecuentes
¿Guarda Golfmanager los datos de las tarjetas?
No. Los datos completos de la tarjeta los custodia Redsys por seguridad. Golfmanager solo guarda una referencia segura (token) y los 4 últimos dígitos, y solo si el cliente acepta guardar la tarjeta.
No aparece Redsys al pagar. ¿Por qué?
Lo habitual es que falten las claves del entorno activo o que el método no esté activo. Revisa las claves del entorno que corresponda (prueba o producción) y que el módulo esté configurado.
El pago se rechaza. ¿Qué hago?
La tarjeta puede estar denegada o la verificación (3DS) no completarse. Revisa el detalle en Transacciones de Redsys; el cliente puede intentarlo con otra tarjeta.
Me aparece el error "0180 - Tarjeta fuera de servicio". ¿Qué significa?
No es un fallo de Golfmanager ni de la pasarela: es un código estándar de Redsys que devuelve el banco emisor de la tarjeta del cliente. Indica que la tarjeta está marcada como "fuera de servicio".
¿Cuáles son las causas del error 0180?
Las más comunes: tarjeta dada de baja (caducada, sustituida o bloqueada), bloqueo temporal del emisor por sospecha de fraude, tarjeta aún no activada, tarjeta no habilitada para comercio electrónico, o restricciones del emisor para pagos online/internacionales no activadas por el cliente.
¿Cómo se resuelve el error 0180?
Es un asunto entre el cliente y su banco, no del club. Se recomienda que el cliente contacte con su banco, pruebe con otra tarjeta y verifique que su tarjeta permite pagos online con 3DS. El club no necesita hacer nada técnico. Solo si muchos clientes distintos reciben el mismo error conviene revisar la configuración de Redsys del tenant (FUC, terminal, modo producción).
El pago presencial no se completa.
Suele deberse a datos del datáfono incorrectos o a que la tarjeta no se presentó. Revisa el código de comercio y la clave de firma y vuelve a intentarlo.
Cobra de verdad en una prueba (o no cobra en real).
El Modo Producción está mal configurado. Actívalo para cobros reales y desactívalo para pruebas.
¿Qué es la "Notificación Síncrona SOAP" y por qué activarla?
Es una confirmación inmediata que permite rechazar el pago si la venta ya no es válida en ese momento (por ejemplo, una reserva caducada). Evita cobrar por algo que ya no procede.
¿Puedo cobrar a un cliente con su tarjeta guardada?
Sí, si tienes activada la tokenización y Redsys ha habilitado el pago por referencia. La tarjeta guardada aparece en la pestaña "Tarjetas Redsys" de la ficha del cliente.
¿Dónde veo si un cobro se completó?
En Transacciones de Redsys. Cada operación muestra su resultado y el detalle del error si lo hubo.
¿Puedo hacer devoluciones desde Golfmanager?
Sí. Al cancelar un pago de Redsys, Golfmanager solicita el reembolso a Redsys y lo registra, sin tener que entrar en el panel de Redsys.
Buenas prácticas recomendadas
Prueba primero en modo test con la tarjeta de pruebas de Redsys antes de operar en real.
Guarda bien las claves de producción y no las compartas; se almacenan cifradas.
Activa "tokenizar tarjetas" solo cuando Redsys confirme el pago por referencia.
Ante un pago fallido, revisa primero Transacciones: el detalle del error suele indicar la causa.
Verifica el modo de producción antes de empezar a cobrar de verdad.
¿Necesitas ayuda?
Si tienes dudas sobre las claves, la configuración o un cobro que no se completa, nuestro equipo de soporte está disponible para ayudarte. Escríbenos en la burbuja azul de tu programa de gestión. Para el alta del comercio, las claves de producción, la activación del pago por referencia o incidencias del lado del banco (como el error 0180), contacta también con Redsys o tu banco.