Índice
¿Qué es esta integración?
La integración con Flutterwave conecta Golfmanager con la pasarela de pago Flutterwave, uno de los proveedores de pagos de referencia en África. Permite que tus clientes paguen online al hacer una reserva o una compra, con distintos métodos: tarjeta, transferencia bancaria o USSD.
También permite guardar la tarjeta del cliente para futuros pagos y procesar devoluciones directamente desde Golfmanager.
Una pasarela de pago es el servicio que conecta tu negocio con los bancos para cobrar de forma segura. USSD es un método de pago muy usado en África: el cliente paga mediante un código que marca en su móvil, sin necesidad de internet.
¿Qué problema resuelve?
Permite cobrar online a clubes que operan con Flutterwave, con varios métodos de pago locales.
Aumenta la seguridad: los datos de pago se introducen en un formulario protegido de Flutterwave y no pasan por los servidores de Golfmanager.
Guarda la tarjeta para que el cliente no tenga que volver a introducirla.
Agiliza las devoluciones: se procesan desde Golfmanager, sin entrar en el panel de Flutterwave.
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta el checkout (pago) de Golfmanager con la pasarela Flutterwave, en tiempo real:
El cliente paga en un formulario seguro de Flutterwave (tarjeta, transferencia o USSD).
Golfmanager verifica la transacción con Flutterwave para confirmar que el pago es real, antes de dar nada por pagado.
Si se confirma, la venta queda marcada como pagada automáticamente.
Para devolver, Golfmanager envía la solicitud de devolución a Flutterwave.
¿Qué información se intercambia?
Información | Dirección | Para qué |
Importe, moneda y email del cliente | Golfmanager → Flutterwave | Iniciar el pago |
Identificador de la transacción | Flutterwave → Golfmanager | Verificar y confirmar el pago |
Solicitud de devolución | Golfmanager → Flutterwave | Reembolsar al cliente |
🔒 Seguridad: los datos de la tarjeta se introducen en el formulario de Flutterwave y no pasan por Golfmanager. Si el cliente guarda la tarjeta, esta se almacena en la cuenta de comercio de Flutterwave.
Requisitos previos (antes de activar la integración)
Tener una cuenta de comercio en Flutterwave (para pruebas, las cuentas sandbox son gratuitas; puedes crearlas con un correo de Golfmanager).
Tener el módulo Flutterwave instalado en tu Golfmanager, junto con el módulo de facturación.
Las credenciales de Flutterwave: Merchant ID, clave pública, clave secreta y clave de cifrado (las obtienes del panel de Flutterwave).
La moneda en la que se cobrará (por ejemplo, NGN), admitida por tu cuenta.
Permisos de administrador de sistema para configurar la integración y ver las transacciones.
Cómo se instala
Hay dos formas de instalar el módulo:
Desde el App Market: ve al App Market, busca el módulo Flutterwave y descárgalo. Si no aparece, contacta con el equipo de soporte de Golfmanager para que te lo habiliten.
Por terminal: si prefieres la instalación manual, el equipo de soporte puede instalarlo mediante un comando en la terminal.
Tras instalarlo, aparece el menú Flutterwave con la Configuración y las Transacciones.
Cómo se configura (paso a paso)
Paso 1 — Obtener las credenciales
Entra en tu panel de Flutterwave y localiza tus claves de API: Merchant ID, Public Key, Secret Key y Encryption Key.
Decide la moneda con la que vas a cobrar (debe estar habilitada en tu cuenta).
Paso 2 — Introducir los datos en Golfmanager
Ve a Flutterwave > Configuración de Flutterwave (sección Datos de la cuenta de Flutterwave).
Introduce el Merchant ID, la Clave pública, la Clave secreta y la Clave de cifrado.
Selecciona la Moneda (por ejemplo, NGN).
Deja el Modo de producción desactivado para empezar a probar.
Guarda los cambios. Las claves se guardan cifradas.
Paso 3 — Probar en modo test
Con el modo de producción desactivado, haz un pago de prueba con una tarjeta de sandbox.
Comprueba en Transacciones de Flutterwave que el pago aparece como correcto.
Paso 4 — Activar producción
Cuando todo funcione, vuelve a la configuración y activa el Modo de producción.
Guarda los cambios. A partir de ese momento, los pagos son reales.
⚠️ Las credenciales de prueba y de producción son distintas. Asegúrate de poner las de producción al activar el modo de producción, y de hacerlo solo cuando las pruebas hayan ido bien.
Detalle de cada campo de configuración
A continuación se explica cada campo de Flutterwave > Configuración de Flutterwave: qué es, cómo afecta al sistema, cómo se comporta y un ejemplo de uso. Todos los datos sensibles se guardan cifrados.
Merchant ID
Nombre del campo: Merchant ID.
Descripción: el identificador de tu comercio en Flutterwave.
Impacto en el sistema: identifica tu cuenta ante la pasarela. Es obligatorio.
Comportamiento del sistema: si falta, la integración no se considera configurada y avisa de que "no hay configuración de Flutterwave".
Ejemplo de uso / qué ocurre: lo copias del panel de Flutterwave y lo pegas aquí.
Clave pública (Public Key)
Nombre del campo: Clave pública.
Descripción: la clave que usa el formulario de pago de Flutterwave en el navegador del cliente.
Impacto en el sistema: es la que inicializa el checkout seguro donde paga el cliente.
Comportamiento del sistema: se envía al navegador para abrir el formulario de pago; es obligatoria.
Ejemplo de uso / qué ocurre: la pegas desde el panel; con ella se muestra el formulario de Flutterwave al cobrar.
Clave secreta (Secret Key)
Nombre del campo: Clave secreta.
Descripción: la clave privada con la que Golfmanager se comunica con la API de Flutterwave.
Impacto en el sistema: se usa para verificar el pago y para enviar las devoluciones. Es la más sensible.
Comportamiento del sistema: nunca se envía al navegador; viaja solo entre Golfmanager y Flutterwave. Es obligatoria.
Ejemplo de uso / qué ocurre: la pegas desde el panel; con ella se confirma cada cobro y se procesan los reembolsos.
Clave de cifrado (Encryption Key)
Nombre del campo: Clave de cifrado.
Descripción: una clave adicional de Flutterwave que tu cuenta exige para los pagos.
Impacto en el sistema: forma parte de las credenciales requeridas para operar.
Comportamiento del sistema: se guarda cifrada junto al resto de credenciales; es obligatoria.
Ejemplo de uso / qué ocurre: la copias del panel de Flutterwave y la pegas aquí.
Moneda
Nombre del campo: Moneda.
Descripción: la moneda en la que se cobran los pagos.
Impacto en el sistema: se envía a Flutterwave en cada cobro; debe estar habilitada en tu cuenta.
Comportamiento del sistema: es única para el club (no hay selección de moneda por pago). Si no está admitida en tu cuenta, el pago se rechaza.
Ejemplo de uso / qué ocurre: pones
NGN(naira nigeriana) y todos los cobros se hacen en esa moneda.
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, procesa cobros reales; desactivado, solo permite pruebas (sandbox).
Comportamiento del sistema: recuerda que las credenciales de prueba y de producción son distintas; al cambiar de modo debes usar las que correspondan.
Ejemplo de uso / qué ocurre: lo dejas desactivado mientras pruebas y lo activas cuando vas a cobrar de verdad.
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 Flutterwave como método de pago.
Se abre el formulario de Flutterwave, donde elige cómo pagar (tarjeta, transferencia o USSD).
Si quiere, marca guardar la tarjeta para futuros pagos.
Al confirmarse el pago, Golfmanager verifica la transacción y la venta queda marcada como pagada.
Guardar la tarjeta para futuros pagos
Durante el pago, el cliente puede marcar la opción de guardar tarjeta. La tarjeta se almacena de forma segura en la cuenta de comercio de Flutterwave (no en Golfmanager) y, en compras futuras, aparece como opción de pago sin tener que volver a introducirla.
Devoluciones
Ve a Reservas > Ocupación.
Selecciona la reserva pagada con Flutterwave que quieras reembolsar.
Ejecuta la devolución total o parcial: Golfmanager envía la solicitud a Flutterwave.
ℹ️ Una devolución siempre se hace sobre un pago original. Si intentas devolver sin un pago de referencia, el sistema avisa de que "debes anular el pago original".
Consultar las transacciones
En Flutterwave > Transacciones de Flutterwave verás todos los cobros y devoluciones enviados a la pasarela. 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, el identificador de la operación en Flutterwave 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
Es para pagos online del cliente (reservas, bonos y tienda), no para el TPV físico.
Flutterwave opera principalmente en África; debes tener una cuenta de comercio válida con ellos.
Las credenciales de prueba y de producción son distintas: recuerda activar el modo de producción (con sus claves) para cobrar de verdad.
Una sola moneda por club: no hay selección de moneda por pago.
Los métodos disponibles (tarjeta, transferencia, USSD) dependen de tu cuenta y país en Flutterwave.
Si el cliente abandona el pago, la venta queda sin pagar y los artículos siguen en el carrito; no hay limpieza automática.
Depende de un servicio externo: si Flutterwave no está disponible, no se pueden procesar pagos en ese momento.
Preguntas frecuentes
¿Qué métodos de pago admite Flutterwave?
Tarjeta, transferencia bancaria y USSD (un código que el cliente marca en su móvil). Los métodos concretos disponibles dependen de tu cuenta y país en Flutterwave.
¿Dónde se introducen los datos de la tarjeta?
En el formulario seguro de Flutterwave, no en Golfmanager. Los datos de la tarjeta no pasan por los servidores de Golfmanager.
¿Cómo instalo el módulo?
Desde el App Market (busca "Flutterwave" y descárgalo; si no aparece, pídelo a soporte) o, alternativamente, por terminal con ayuda de soporte. Después aparece el menú Flutterwave con la configuración y las transacciones.
¿De dónde saco el Merchant ID y las claves?
Del panel de control de Flutterwave. Allí están el Merchant ID, la clave pública, la clave secreta y la clave de cifrado. Si no tienes cuenta de producción, puedes crear una de prueba (sandbox) gratis.
¿Para qué sirve el "Modo de producción"?
Activado, procesa cobros reales; desactivado, solo permite pruebas (sandbox). Empieza desactivado, prueba, y actívalo cuando todo funcione (con las claves de producción).
Sale "No hay configuración de Flutterwave". ¿Qué reviso?
Faltan el Merchant ID o alguna de las claves. Ve a Flutterwave > Configuración de Flutterwave y comprueba que todos los datos estén rellenos.
Sale "Error al cargar la configuración de Flutterwave" o "Pasarela inactiva". ¿Qué hago?
La configuración no se ha podido leer o está incompleta. Revisa que las credenciales sean correctas y estén guardadas; si persiste, contacta con soporte.
El cliente no ve Flutterwave al pagar. ¿Por qué?
Porque el módulo no está instalado o el método no está disponible en ese contexto. Instálalo desde el App Market y comprueba la configuración.
El pago se ha rechazado. ¿Qué hago?
El pago lo ha denegado el banco o Flutterwave. Revisa el detalle en Transacciones; el cliente puede intentarlo con otro método o tarjeta.
¿Cómo verifica Golfmanager que el pago es real?
Tras pagar el cliente, Golfmanager consulta a Flutterwave el estado de la transacción con la clave secreta. Solo si Flutterwave confirma que fue correcta, la venta se marca como pagada. Así se evita dar por pagado algo que no se cobró.
¿Cómo hago una devolución?
En Reservas > Ocupación, selecciona la reserva pagada con Flutterwave y ejecuta la devolución total o parcial. Golfmanager envía la solicitud a Flutterwave.
¿Puedo hacer devoluciones parciales?
Sí. Puedes devolver el importe completo o una parte. La devolución siempre se hace sobre el pago original.
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.
¿Qué pasa si el cliente cierra el formulario sin pagar?
La venta queda sin pagar y los artículos siguen en el carrito. La operación se registra como no completada. El cliente puede volver a intentarlo entrando de nuevo al pago.
¿Funciona el guardado de tarjeta?
Sí. Si el cliente marca guardar tarjeta, esta se almacena en la cuenta de comercio de Flutterwave y aparece como opción en futuras compras, sin volver a teclearla.
¿Qué moneda puedo usar?
La que tengas habilitada en tu cuenta de Flutterwave (por ejemplo, NGN). Es una sola moneda para todo el club; si configuras una no admitida, los pagos se rechazan.
¿Sirve para el TPV físico de recepción?
No. Esta integración es para pagos online del cliente (reservas, bonos y tienda), no para el datáfono del TPV.
¿En qué se pueden usar los pagos de Flutterwave?
En lo que el cliente paga online desde el portal: reservas, bonos y compras de la tienda (recargas de saldo incluidas).
¿Dónde veo el estado de un pago o una devolución?
En Flutterwave > Transacciones de Flutterwave: ahí está el cliente, el importe, si fue correcto o fallido, el identificador en Flutterwave y el detalle del error si lo hubo.
¿Las claves están seguras?
Sí. Todas las credenciales (Merchant ID, claves pública, secreta y de cifrado) se guardan cifradas. Aun así, no las compartas y trátalas como contraseñas.
¿Hay que reautorizar o renovar algo periódicamente?
No. No usa tokens que caduquen. Mientras las credenciales sean válidas, la integración funciona.
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.
¿Qué permisos necesito para configurar la integración?
Permisos de administrador de sistema, que dan acceso a la configuración de Flutterwave y a las transacciones.
¿Qué hago antes de empezar a cobrar de verdad?
Haz un cobro y una devolución de prueba en modo sandbox, valídalos en Transacciones, y solo entonces activa el modo de producción con las claves reales.
Buenas prácticas recomendadas
Prueba primero en modo test con las tarjetas de sandbox antes de activar producción.
Guarda bien las credenciales de producción y no las compartas; se almacenan cifradas en Golfmanager.
Configura la moneda correcta según tu cuenta de Flutterwave.
Ante un pago fallido, revisa primero Transacciones: el detalle del error suele indicar la causa.
Haz un cobro y una devolución de prueba al implantar, para validar todo el ciclo.