Índice
¿Qué es esta integración?
La integración con Comercia Global Payments conecta el TPV de Golfmanager con el datáfono (terminal de pago con tarjeta) de Comercia Global Payments. Cuando cobras una venta con tarjeta en el TPV, Golfmanager envía el importe directamente al datáfono: el cliente paga en el terminal y el resultado vuelve a Golfmanager, que marca la venta como pagada.
Es una integración de pago presencial en el mostrador (cobro con tarjeta en caja), no de pagos online.
Existen dos variantes de la integración según el tipo de terminal: la clásica (Comercia Global Payments) y la "Agnóstica" (la más reciente, por ejemplo el datáfono ITOS CM35 conectado por red). La forma de cobrar en el TPV es la misma; cambia el módulo que se instala, el tipo de terminal y cómo se conecta. La versión semi-integrada antigua está obsoleta: hoy se usa la tecnología Agnóstica.
¿Qué problema resuelve?
Evita teclear el importe en el datáfono: el importe se envía automáticamente desde el TPV, eliminando errores.
Cuadra caja automáticamente: el cobro con tarjeta queda registrado en la venta de Golfmanager sin pasos manuales.
Agiliza el cobro en el mostrador y reduce los descuadres entre el TPV y el terminal.
Evita cobros duplicados: si hay un corte de conexión, Golfmanager comprueba si la operación ya se hizo en el datáfono antes de volver a cobrar.
Contacto de contratación en España: Pablo Castiglia — pablocastiglia@comerciaglobalpay.com
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta el TPV de Golfmanager con el datáfono de Comercia Global Payments, a través de la red local del club:
Golfmanager envía el importe a cobrar (o a devolver) al terminal.
El cliente paga con su tarjeta en el datáfono.
El terminal devuelve el resultado (aprobado o rechazado) y un identificador de ticket, que Golfmanager guarda para poder anular o devolver después.
Si todo va bien, la venta queda marcada como pagada en el TPV.
¿Qué información se intercambia?
Información | Dirección | Para qué |
Importe a cobrar (o a devolver) | Golfmanager → Datáfono | Que el terminal pida el pago al cliente |
Resultado del pago e identificador de ticket | Datáfono → Golfmanager | Confirmar el cobro y poder anularlo/devolverlo |
🔒 Seguridad: la tarjeta se lee y procesa en el propio datáfono. Golfmanager solo envía el importe y recibe el resultado; los datos sensibles de la tarjeta no pasan por el software.
Requisitos previos (antes de activar la integración)
Tener un datáfono de Comercia Global Payments compatible. Para la variante Agnóstica, el modelo ITOS CM35, solicitado al banco con tecnología Agnóstica (la versión semi-integrada anterior está obsoleta).
Tener el módulo correspondiente instalado en tu Golfmanager (Comercia Global Payments o su versión Agnóstica), junto con los módulos de TPV y facturación.
Que el datáfono y el equipo del TPV estén en la misma red local (la misma WiFi) y el terminal sea accesible desde el TPV.
Conocer la dirección (IP/URL) del datáfono para asociarlo al TPV.
Permisos adecuados (gestión de facturación) para configurar el TPV y la facturación.
Cómo se configura (paso a paso)
Los pasos siguientes describen la puesta en marcha (con el detalle de la variante Agnóstica / ITOS CM35, la más habitual). La variante clásica es equivalente, cambiando el módulo y el campo de la URL del terminal.
Paso 1 — Preparar el datáfono
Asegúrate de tener el modelo ITOS CM35, solicitado al banco con tecnología Agnóstica.
Conecta el datáfono a la misma red WiFi que el ordenador del TPV.
Paso 2 — Instalar el módulo en Golfmanager
Ve a Configuración > Sistema > App Market.
Instala el módulo Comercia Globalpayments Agnóstica (o la variante clásica, según tu terminal).
Se añadirá automáticamente una nueva forma de pago en el TPV: Comercia Global Payments Agnóstica. Es de tipo "pasarela", pero en caja la verás como pago con tarjeta.
Paso 3 — Obtener la IP del datáfono
En el datáfono, accede a la configuración de red.
Mantén pulsado en la parte derecha de tu red WiFi para abrir la configuración avanzada.
Introduce la contraseña:
thb357.Localiza la dirección IP asignada al dispositivo (por ejemplo,
192.168.20.211).
Paso 4 — Asociar el datáfono al TPV
En Golfmanager, ve a Configuración > TPV > Listado de TPVs.
Selecciona el TPV que vas a asociar al datáfono.
En el campo URL del terminal Agnóstica, introduce la dirección en el formato
https://IP_DEL_DATAFONO:3000(por ejemplo,https://192.168.20.211:3000).Guarda los cambios.
⚠️ Importante: es obligatorio añadir :3000 al final, y que la dirección empiece por https://. Cada TPV se asocia a su propio datáfono. (En la variante clásica, el campo es URL del terminal y el cobro pasa por el servidor local de la impresora del TPV.)
Paso 5 — Realizar una prueba
Accede al TPV.
Genera un ticket de prueba.
Selecciona la forma de pago con tarjeta (Comercia Global Payments Agnóstica).
Verifica que el importe se envía automáticamente al datáfono (no deberías tener que teclearlo a mano).
Detalle de cada campo de configuración
A continuación se explica cada campo: qué es, cómo afecta al sistema, cómo se comporta y un ejemplo de uso con lo que ocurre al utilizarlo.
URL del terminal Agnóstica
Nombre del campo: URL del terminal Agnóstica, en la ficha del TPV (Configuración > TPV > Listado de TPVs).
Descripción: la dirección del datáfono Agnóstica en la red local, incluyendo el puerto.
Impacto en el sistema: es por donde el TPV envía el importe al terminal. Sin ella (o si es incorrecta), el TPV no puede cobrar por tarjeta con ese datáfono.
Comportamiento del sistema: al cobrar, Golfmanager se conecta a esta dirección para enviar el pago y recibir el resultado.
Ejemplo de uso / qué ocurre: pones
https://192.168.20.211:3000(conhttps://y:3000obligatorios) y guardas. A partir de ahí, ese TPV cobra contra ese datáfono.
URL del terminal (variante clásica)
Nombre del campo: URL del terminal, en la ficha del TPV (solo en la variante clásica).
Descripción: la dirección del datáfono de la variante clásica (por ejemplo,
https://192.168.1.72:2001).Impacto en el sistema: indica al TPV a qué terminal enviar el cobro en la variante clásica.
Comportamiento del sistema: el cobro se enruta a través del servidor local de la impresora del TPV hasta el terminal.
Ejemplo de uso / qué ocurre: rellenas la dirección del terminal clásico y guardas; el TPV ya puede cobrar contra ese datáfono.
Servidor local / URL Server (variante clásica)
Nombre del campo: URL Server, en la impresora asociada al TPV (por ejemplo,
http://localhost:9090).Descripción: la dirección del servidor local (el de la impresora del TPV) que hace de puente con el datáfono en la variante clásica.
Impacto en el sistema: sin un servidor local configurado, el cobro de la variante clásica no puede llegar al terminal.
Comportamiento del sistema: el TPV envía la petición al servidor local, y este la reenvía al datáfono.
Ejemplo de uso / qué ocurre: si te aparece el aviso "No hay un servidor local configurado", revisa que la impresora del TPV tenga su URL Server rellena.
API key de Agnóstica
Nombre del campo: API key (clave de la integración Agnóstica). La gestiona Golfmanager a nivel de sistema.
Descripción: la clave que autoriza la comunicación entre Golfmanager y el datáfono Agnóstica.
Impacto en el sistema: si la clave no es correcta, el terminal rechaza las peticiones con un error de autenticación.
Comportamiento del sistema: se envía con cada petición al datáfono.
Ejemplo de uso / qué ocurre: normalmente no tienes que tocarla. Si ves el mensaje "Error de autenticación. Revisa la API key", contacta con soporte para verificarla.
Configuración del lector de tarjetas (acción)
Nombre del campo: es una acción (botón), no un campo de texto: "Configuración del datáfono" / "Configuración del lector de tarjetas (Agnóstica)".
Descripción: abre la pantalla de ajustes del propio datáfono.
Impacto en el sistema: permite ajustar el terminal sin salir del entorno del TPV.
Comportamiento del sistema: solo está disponible desde el propio datáfono (la app del terminal). Desde un navegador normal mostrará un aviso de que esa acción solo puede usarse desde el datáfono.
Ejemplo de uso / qué ocurre: si necesitas ajustar el lector, usa esta acción desde el dispositivo; en otro equipo no estará operativa.
Cómo se usa en el día a día
Cobrar con tarjeta
En el TPV, añade los productos y ve a cobrar.
Selecciona Comercia Global Payments (la forma de pago con tarjeta) como forma de pago.
Golfmanager envía el importe al datáfono. El cliente paga con su tarjeta en el terminal.
Cuando el terminal aprueba el pago, la venta queda marcada como pagada automáticamente, y los datos del pago (tipo de tarjeta, número de autorización…) pueden imprimirse en el ticket.
Devoluciones / anulaciones
Para devolver un cobro, Golfmanager envía la anulación al datáfono usando el identificador de ticket guardado de la operación original. El terminal procesa la devolución a la tarjeta. La devolución necesita los datos de la transacción original (su identificador de ticket), por eso se hace desde la venta original.
Si hay un corte de conexión
Si el pago se completó en el datáfono pero no llegó a registrarse en Golfmanager (por ejemplo, por un corte de red), la integración lo detecta en el siguiente intento y no vuelve a cobrar: reconoce que esas ventas ya estaban pagadas. Además, la variante Agnóstica puede consultar el estado de la transacción en el terminal para recuperarla. Y si el servidor llegara a rechazar un pago después de haberse cobrado en el datáfono, la integración intenta revertir automáticamente ese cargo. Así se evitan los cobros duplicados.
Consultar las transacciones
En Facturación > Transacciones GlobalPayments (o Transacciones GlobalPayments Agnóstica, según la variante) verás todas las operaciones enviadas al datáfono. Cada registro muestra:
El carrito de compra y el importe.
El TicketId del terminal (necesario para anulaciones).
Las ventas asociadas.
El estado de la operación (Éxito / No) y si tiene devolución.
El mensaje o resultado devuelto por el terminal.
Es la primera pantalla a revisar cuando un cobro no se ha completado o hay dudas sobre una operación; además, el mensaje de error que verás aquí es el que conviene facilitar al soporte de Comercia si hace falta.
Limitaciones a tener en cuenta
Es para cobro presencial en el TPV con datáfono físico, no para pagos online.
Requiere red local: el datáfono debe estar accesible desde el equipo del TPV (misma WiFi). Sin red, no hay cobro automático.
Cada TPV se asocia a su propio terminal mediante su dirección (URL/IP).
Hay dos variantes (clásica y Agnóstica) según el tipo de datáfono; usa el módulo y el campo que corresponda a tu terminal. La semi-integrada antigua está obsoleta.
No guarda tarjetas: es un cobro presencial; no hay tarjetas guardadas ni cobros recurrentes por esta vía.
La variante Agnóstica cobra en euros.
Depende del terminal: si el datáfono está apagado, sin conexión, sin claves inyectadas o con incidencias, no se podrá cobrar por esta vía.
Preguntas frecuentes
¿Esta integración es para pagos online o presenciales?
Para pagos presenciales en el mostrador: el cobro con tarjeta en el TPV usando un datáfono físico. No es para cobrar en la web de reservas online.
¿Qué diferencia hay entre la variante clásica y la Agnóstica?
La forma de cobrar en caja es la misma; cambian el módulo que se instala, el tipo de terminal y cómo se conecta. La Agnóstica (por ejemplo, el ITOS CM35) es la arquitectura más reciente y se conecta por red con una URL del tipo https://IP:3000. La clásica enruta el cobro a través del servidor local de la impresora del TPV. Usa el módulo y el campo que correspondan a tu datáfono.
¿Qué datáfono necesito?
Para la variante Agnóstica, el modelo ITOS CM35, solicitado al banco con tecnología Agnóstica. La versión semi-integrada anterior está obsoleta. Si tienes dudas sobre tu terminal, consúltalo con Comercia Global Payments.
¿Por qué hay que poner ":3000" en la URL del terminal?
Porque el datáfono Agnóstica escucha en el puerto 3000. La dirección debe ir en el formato https://IP_DEL_DATAFONO:3000, empezando por https:// y terminando en :3000. Si falta el puerto o el https://, el TPV no podrá conectar con el terminal.
¿Cómo encuentro la dirección IP del datáfono?
En el datáfono, entra en la configuración de red, mantén pulsado en la parte derecha de tu red WiFi para abrir la configuración avanzada, introduce la contraseña thb357 y localiza la dirección IP asignada al dispositivo (por ejemplo, 192.168.20.211).
El TPV no envía el importe al datáfono. ¿Qué reviso?
Comprueba, por este orden: que el TPV y el datáfono estén en la misma red; que la IP introducida sea correcta; que la URL incluya https:// y el sufijo :3000; y que el datáfono sea el modelo ITOS CM35 con tecnología Agnóstica y esté encendido. Si tras estas comprobaciones sigue sin funcionar, contacta con soporte.
Veo "No hay un servidor local configurado". ¿Qué significa?
Es propio de la variante clásica: el cobro pasa por el servidor local de la impresora del TPV, y ese servidor no está configurado. Revisa que la impresora asociada al TPV tenga su URL Server rellena.
Veo "No hay una URL de terminal configurada". ¿Qué reviso?
Al TPV le falta la dirección del datáfono. Ve a Configuración > TPV > Listado de TPVs, abre ese TPV y rellena la URL del terminal Agnóstica (o "URL del terminal" en la clásica), y guarda.
Sale un error de que el datáfono no responde o no se puede conectar. ¿Qué hago?
Indica que Golfmanager no ha podido comunicarse con el terminal. Comprueba que el datáfono está encendido y conectado a la red, que la dirección (IP y puerto) es correcta y que ambos están en la misma WiFi. Estos avisos suelen incluir la URL del terminal para ayudarte a verificarla.
Sale "Error de autenticación. Revisa la API key". ¿Qué significa?
Es propio de la variante Agnóstica: la clave de la integración (API key) no es válida, así que el terminal rechaza las peticiones. Esta clave la gestiona Golfmanager a nivel de sistema; contacta con soporte para verificarla.
Se cobró en el datáfono pero la venta sigue sin pagar. ¿Qué hago?
Normalmente, un corte de conexión entre el terminal y Golfmanager. Reintenta el cobro: la integración detecta que el pago ya se hizo en el datáfono y no vuelve a cobrar, simplemente marca la venta como pagada. No teclees el importe a mano en el datáfono, para no duplicar el cobro.
Sale "Las ventas ya están pagadas". ¿Qué significa?
Que esas ventas ya se cobraron en el datáfono en un intento anterior. No vuelvas a cobrar; verifica el estado de la venta y de la transacción en Transacciones GlobalPayments.
¿Qué pasa si el sistema rechaza un pago después de haberse cobrado en el datáfono?
La integración intenta revertir automáticamente ese cargo en el terminal y te avisa de que está deshaciendo el cobro. Si la reversión automática no fuese posible, verás el aviso "No se pudo revertir el cargo del terminal. Devuélvelo manualmente": en ese caso, haz la devolución desde el datáfono.
¿Cómo hago una devolución a un cliente?
Desde la venta original, lanza la anulación/devolución. Golfmanager envía la orden al datáfono usando el identificador de ticket de la operación original, y el terminal devuelve el importe a la tarjeta. Por eso es necesario partir de la venta original (que es donde está guardado ese identificador).
¿Puedo guardar la tarjeta del cliente para cobros recurrentes?
No. Esta integración es de cobro presencial con el datáfono; no guarda tarjetas ni permite cobros recurrentes automáticos. Para eso se usan otras pasarelas de pago online.
¿En qué moneda se cobra?
La variante Agnóstica opera en euros. En la variante clásica, la moneda la determina la configuración del propio terminal.
Veo mensajes como "El terminal no tiene claves inyectadas" o "Número de comercio no establecido". ¿Qué significan?
Son avisos de que el propio datáfono no está correctamente provisto/configurado por el banco (le faltan las claves o el número de comercio). No se resuelven desde Golfmanager: contacta con el soporte de Comercia Global Payments para que dejen el terminal listo.
El cliente o el terminal cancela la operación (por tiempo o manualmente). ¿Qué veo?
Verás un mensaje del tipo "Pago cancelado por el usuario" o "Transacción cancelada por tiempo de espera". Simplemente vuelve a intentar el cobro cuando el cliente esté listo.
Sale "La app de pago está ocupada. Inténtalo de nuevo". ¿Qué hago?
Es un aviso temporal: el terminal está procesando otra cosa. Espera unos segundos y reintenta el cobro.
¿Cada TPV necesita su propio datáfono?
Sí. Cada TPV se asocia a un terminal mediante su dirección (URL/IP). Si tienes varios puntos de cobro, cada uno apunta a su propio datáfono.
¿La forma de pago aparece como "pasarela" o como "tarjeta"?
Internamente es de tipo pasarela, pero en caja la verás y la usarás como un pago con tarjeta normal.
¿Dónde compruebo si un cobro ha salido bien?
En Facturación > Transacciones GlobalPayments (Agnóstica). Cada operación muestra el carrito, el importe, el TicketId, las ventas asociadas, el estado (Éxito / No), si tiene devolución y el mensaje del terminal.
¿Qué permisos necesito para configurar la integración y ver las transacciones?
Permiso de gestión de facturación (y acceso a la configuración del TPV). Con él puedes asociar el datáfono al TPV y consultar el listado de transacciones.
¿Necesito conexión a internet para cobrar?
El cobro entre el TPV y el datáfono va por la red local. El datáfono, a su vez, necesita su conexión con el banco para autorizar la tarjeta. Si la red local falla, el TPV no podrá enviar el importe automáticamente.
¿A quién contacto si el problema es del datáfono?
Si la incidencia es del terminal (conexión, errores del datáfono, problemas técnicos del dispositivo), contacta con el soporte oficial de Comercia Global Payments (ver la sección "Soporte y contacto"). Antes, revisa el mensaje de error en Transacciones GlobalPayments, porque te lo pueden pedir.
Soporte y contacto
Soporte de Golfmanager: para dudas sobre la configuración en Golfmanager (módulo, asociación del TPV, transacciones), contacta con el equipo de soporte de Golfmanager.
Soporte de Comercia Global Payments (incidencias del terminal: conexión, errores del datáfono, problemas técnicos del dispositivo):
Teléfono: 93 595 43 83 · 902 157 235 · 914 353 028
Horario: de lunes a viernes, de 9:00 a 20:00.
Contratación en España: Pablo Castiglia — pablocastiglia@comerciaglobalpay.com
💡 Recomendación: antes de contactar con soporte, revisa la sección de Transacciones GlobalPayments en Golfmanager para identificar el mensaje de error, ya que puede ser necesario facilitar esta información al equipo técnico.
Buenas prácticas recomendadas
Verifica la conexión del datáfono con un cobro de prueba al implantar y tras cualquier cambio de red.
Asegura una red local estable entre el TPV y el terminal para evitar cortes durante el cobro.
Ante un fallo, reintenta el cobro en lugar de teclearlo manualmente en el datáfono: así evitas cobros duplicados.
Comprueba que la URL del terminal empieza por
https://e incluye el puerto (:3000en Agnóstica).Ante cualquier duda sobre una operación, revisa Transacciones GlobalPayments: el resultado y el mensaje suelen indicar la causa, y son la información que pedirá el soporte.