Índice
Introducción
Esta integración permite cobrar y devolver con el datáfono de Global Payments directamente desde el TPV de Golfmanager: el importe se envía al terminal, y cuando el cliente aprueba el pago, la venta queda cobrada y registrada en Golfmanager sin teclear nada en el datáfono.
Requisitos previos
Datáfono de Global Payments compatible con la Arquitectura Agnóstica (AppConector).
Servicio InStorePayment de Comercia instalado y en marcha en cada puesto Windows que vaya a cobrar, y emparejado con el datáfono de ese puesto.
API Key del AppConector.
Plugin Global Payments Agnostica instalado en el club (lo activa Golfmanager).
Al instalarse en Golfmanager, el plugin crea la forma de pago "Global Payments Agnostica", ya disponible en el TPV y marcada como pago con tarjeta.
Si no aparece la forma de pago en el TPV, revisar las Formas de pago personalizadas de la caja.
Configuración inicial
Preparar cada puesto Windows. El navegador del TPV habla con el servicio InStorePayment del propio puesto, y esa llamada va por HTTPS. En cada equipo que vaya a cobrar hay que hacer lo siguiente:
Activar SSL en el servicio. En el fichero config.json de InStorePayment, poner el valor SSL a true y reiniciar el servicio. Con el servicio escuchando por HTTP el navegador bloquea las llamadas y el cobro no llega al datáfono.
Añadir el alias al fichero hosts. Editar como administrador C:\Windows\System32\drivers\etc\hosts y añadir esta línea, sin
almohadilla delante:
127.0.0.1 instorepaymentapi.globalpayments.es
El certificado del servicio está emitido solo para ese nombre: no vale localhost ni la IP del equipo. Comprobar con ping
instorepaymentapi.globalpayments.es que responde 127.0.0.1 .Instalar los certificados de Comercia. Vienen con el instalador de InStorePayment, en C:\Comercia\InStorePaymentApi\Cer\ .
Desde una consola de administrador:
certutil -addstore -f Root "C:\Comercia\InStorePaymentApi\Cer\CGP_CA_ROOT.cer"
certutil -addstore -f CA "C:\Comercia\InStorePaymentApi\Cer\CGP_CA_EMISORA.cer"
Cada certificado va a su almacén y no valen indistintamente, así que no sirve instalarlos a doble clic dejando que Windows elija.
Verificar con certutil -store Root | findstr CGP y certutil -store CA | findstr CGP .Asociar el terminal con el servicio, un terminal por ordenador.
Guardar la configuración del plugin
Ir a Configuración > Global Payments Agnostica > Configuración.
API Key: la clave del AppConector facilitada por Global Payments. Se almacena cifrada.
Markdown Live Preview https://markdownlivepreview.com/
1 de 4 16/09/2026, 12:14fDirección del servicio InStorePayment: instorepaymentapi.globalpayments.es (el https:// y el puerto :3000 se añaden solos), si
hiciera falta otro puerto sí que hay que indicarlo.
Pulsar Guardar.
Ambos valores son comunes a todo el club: no hay que dar de alta terminales ni seleccionar nada en cada puesto. Como el alias
del fichero hosts apunta a 127.0.0.1 , cada navegador acaba hablando con el servicio de su propio equipo, y por tanto con el
datáfono emparejado con él.Comprobar que el puesto llega al datáfono
Abrir en una pestaña del propio puesto:
https://instorepaymentapi.globalpayments.es:3000/v1/getDeviceConfig
Si responde, el montaje está bien. Si da error, el mensaje del navegador dice qué falta (ver Resolución de problemas).
Cobrar en el TPV
Añadir las líneas a la venta y pulsar Cobrar.
Elegir la forma de pago Global Payments Agnostica.
Golfmanager muestra una ventana con el importe y envía la operación al datáfono.
El cliente paga en el terminal siguiendo sus instrucciones.
Con la aprobación, la venta queda pagada y se genera el ticket automáticamente.
Consideraciones:
El cobro debe ser por el importe total: esta forma de pago no admite pagos partidos ni importes parciales.
Para cancelar antes de que el cliente pague, usar el botón Anular de la ventana o el botón rojo del datáfono.
Si se cierra la ventana con el pago ya en curso, la operación sigue su curso en el datáfono y el cobro se registra igualmente.
Si el pago se aprueba pero Golfmanager no puede registrar la venta (por ejemplo, porque otra persona ha cancelado una línea mientras tanto), el sistema devuelve el importe automáticamente en el datáfono y muestra el motivo real del fallo.
Devoluciones
Las devoluciones deben hacerse siempre desde el TPV, anulando las líneas de la venta. Al hacerlo, Golfmanager pide el abono al datáfono y, una vez confirmado, genera el ticket de anulación con el pago negativo y deja las líneas pendientes.
Si las líneas estaban facturadas, aparece la opción Generar factura rectificativa.
Anular la factura desde Facturación es un movimiento contable que no pasa por la pasarela: no devuelve el dinero en el datáfono, habría que devolverlo a mano.
Si el abono se realiza en el datáfono pero Golfmanager no llega a registrarlo, basta con repetir la anulación desde el TPV: el sistema detecta el abono ya hecho y completa solo la parte de Golfmanager, sin volver a devolver dinero.
Datos de la tarjeta en el ticket
El ticket de venta impreso desde el TPV incluye, al final, los datos del pago con tarjeta: marca, tipo, número enmascarado ( **** **** **** 1234 ) y código de autorización. Es información añadida por Golfmanager; el recibo del datáfono se imprime aparte, desde el propio terminal.
Consultar las transacciones
Markdown Live Preview https://markdownlivepreview.com/
2 de 4 16/09/2026, 12:14
En Menú de Configuración > Global Payments Agnóstica > Transacciones queda registrada cada operación enviada al datáfono: fecha, venta, importe, si es devolución, si ha tenido éxito, ticket generado, datos de tarjeta, resultado devuelto por el terminal y mensaje.
En el detalle de cada transacción se ven además las líneas de venta implicadas.
Es el primer sitio donde mirar ante cualquier duda sobre un cobro concreto.
Resolución de problemas
Cuando el cobro no llega al datáfono, el TPV suele mostrar un error genérico de CORS o de conexión. Para saber qué pasa de verdad, abrir en ese mismo puesto https://instorepaymentapi.globalpayments.es:3000/v1/getDeviceConfig y mirar el error del navegador:
Resto de situaciones habituales:
Si hace falta más detalle, el propio servicio deja un registro de cada llamada al datáfono en C:\Comercia\InStorePaymentApi\Logs\InStorePaymentApi.log .
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
Helpdesk & Customer care: 911 501 255
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.