Ir al contenido principal

Global Payments (Arquitectura Agnóstica)

Guía completa de Comercia Global Payments: cobro presencial con datáfono en el TPV (Agnóstica), configuración paso a paso, detalle de cada campo, devoluciones, transacciones, soporte y preguntas frecuentes.

Í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

  1. 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:

    1. 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.

    2. 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 .

    3. 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 .

    4. Asociar el terminal con el servicio, un terminal por ordenador.

  2. 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:14f

    Direcció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.

  3. 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

  1. Añadir las líneas a la venta y pulsar Cobrar.

  2. Elegir la forma de pago Global Payments Agnostica.

  3. Golfmanager muestra una ventana con el importe y envía la operación al datáfono.

  4. El cliente paga en el terminal siguiendo sus instrucciones.

  5. Con la aprobación, la venta queda pagada y se genera el ticket automáticamente.


​Consideraciones:
El cobro debe ser por el importe total de las líneas: esta forma de pago no admite pagos partidos ni importes parciales (ver Pagos partidos e 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.

Pagos partidos e importes parciales

La forma de pago Global Payments Agnostica siempre cobra el importe total de las líneas seleccionadas en una única operación del datáfono. No es posible modificar el importe en la ventana de cobro, cobrar solo una parte de una línea ni combinar, sobre las mismas líneas, este cobro con otra forma de pago.

Explicación técnica

Cada cobro genera un registro en Global Payments Agnóstica > Transacciones que vincula, de forma unívoca:

  • La venta desde la que se lanza el cobro.

  • El importe enviado al datáfono. No se teclea: Golfmanager lo calcula sumando las líneas pendientes y lo envía al servicio InStorePayment del puesto, que lo traslada al terminal.

  • Las líneas de venta que ese importe liquida.

  • La respuesta del terminal (autorización, datos de tarjeta y resultado).

Esta relación 1:1 entre una operación del datáfono y un conjunto de líneas pagadas al 100 % es la base de los automatismos de la integración:

  • Marcar las líneas como pagadas y generar el ticket al recibir la aprobación.

  • Devolver automáticamente el importe si la venta no se puede registrar.

  • Al anular líneas desde el TPV, identificar qué operación hay que abonar en el datáfono y por qué importe.

  • Detectar un abono ya realizado para no devolver el dinero dos veces.

Si se admitieran importes parciales, una misma línea quedaría pagada en parte con el datáfono y en parte con otra forma de pago u otra operación. Al anularla, el sistema no podría determinar qué importe abonar ni sobre qué operación, y la conciliación entre Golfmanager y Global Payments dejaría de cuadrar. Por eso la integración exige liquidar las líneas completas en una sola operación.

Soluciones: cómo repartir el pago

La clave es que cada operación del datáfono liquide líneas completas. El TPV ofrece tres formas de conseguirlo. Elegir según el caso:

  • Opción 1 – Seleccionar líneas: el reparto coincide con líneas completas (por ejemplo, cada jugador paga su green fee).

  • Opción 2 – Dividir la venta: hay que repartir una misma venta o línea entre varios pagadores o formas de pago (por ejemplo, a partes iguales).

  • Opción 3 – Bono monedero: el cliente quiere pagar con tarjeta un importe concreto que no coincide con ninguna línea.

Opción 1: Seleccionar líneas concretas

  1. En el TPV, seleccionar solo las líneas que se van a pagar con tarjeta.

  2. Pulsar Cobrar y elegir Global Payments Agnostica. El importe enviado al datáfono será exactamente la suma de esas líneas.

  3. Esperar la aprobación en el terminal y comprobar que se genera el ticket.

  4. Seleccionar las líneas restantes y cobrarlas con la otra forma de pago. Si se paga con una segunda tarjeta, repetir los pasos 1 a 3: cada tarjeta será una operación independiente.

  5. Verificar en Global Payments Agnóstica > Transacciones que cada operación aparece con sus líneas e importe correctos.

Devoluciones: automáticas. Cada operación queda asociada a sus propias líneas.

Opción 2: Dividir la venta

  1. En el TPV, utilizar la opción Dividir venta sobre la venta que se quiere repartir.

  2. Dividirla hasta que cada parte corresponda exactamente con lo que se va a pagar con cada forma de pago o cada tarjeta.

  3. Seleccionar la parte que se paga con tarjeta, pulsar Cobrar y elegir Global Payments Agnostica.

  4. Cobrar el resto de partes con su forma de pago. Cada tarjeta adicional será una operación independiente del datáfono.

  5. Verificar en Global Payments Agnóstica > Transacciones que cada operación aparece con su importe correcto.

Devoluciones: automáticas. Al dividir, cada parte se convierte en líneas propias, que se liquidan de forma completa.

Opción 3: Bono monedero

Permite cobrar con tarjeta cualquier importe, aunque no coincida con las líneas de la venta: la tarjeta paga una recarga de monedero (una línea completa) y la venta se paga después con ese saldo.

  1. Añadir en el TPV la recarga del bono monedero del cliente por el importe exacto que quiere pagar con tarjeta. Si el cliente no tiene bono monedero, crearlo primero.

  2. Cobrar solo la línea de recarga con Global Payments Agnostica. Como es una línea completa, el datáfono cobra exactamente ese importe.

  3. Seleccionar las líneas de la venta y pagarlas usando el saldo del bono monedero.

  4. Cobrar el importe pendiente con la otra forma de pago.

  5. Comprobar que el saldo del bono monedero queda en el valor esperado (normalmente 0).

⚠️ Devoluciones con esta opción: al anular las líneas de la venta, el importe vuelve al bono monedero, no a la tarjeta. Si hay que devolver el dinero en la tarjeta, después hay que anular desde el TPV la línea de recarga del bono, y Golfmanager pedirá el abono al datáfono.

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):

💡 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.


​

¿Ha quedado contestada tu pregunta?