Índice
¿Qué es esta integración?
La integración con NMI conecta Golfmanager con la pasarela de pago NMI. Es una de las integraciones de pago más completas: permite cobros online con tarjeta, guardar la tarjeta del cliente para futuros pagos, cobro presencial con datáfono en el TPV, preautorizaciones (retención de fondos) y devoluciones (totales o parciales).
NMI es una plataforma de pagos sobre la que operan muchos proveedores. Si trabajas con un proveedor basado en NMI —por ejemplo, Fort Point Payments—, la conexión con Golfmanager se hace a través de este mismo módulo NMI, usando las credenciales que te facilite ese proveedor.
¿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.
Permite retener fondos (preautorización) y cobrarlos después, útil para depósitos/fianzas.
Mayor seguridad: los datos de la tarjeta se gestionan de forma segura (tokenización); no se guardan en Golfmanager.
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 un lector/terminal NMI |
Preautorización y captura | Retener fondos y cobrarlos después (o liberarlos) |
Devolución | Reembolsar total o parcialmente una venta |
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta Golfmanager con la pasarela NMI en tiempo real:
En el pago online, la tarjeta se introduce en un formulario seguro y NMI devuelve un token; Golfmanager pide el cobro con ese token.
En el pago presencial, Golfmanager envía el cobro al datáfono a través de NMI y consulta el resultado hasta que el cliente presenta la tarjeta.
NMI confirma cada operación (pago, preautorización, captura o devolución) y Golfmanager la registra.
🔒 Seguridad: los datos de la tarjeta se gestionan mediante tokenización con NMI. Golfmanager guarda una referencia segura (token), no el número de tarjeta.
Requisitos previos (antes de activar la integración)
Tener una cuenta de NMI o de un proveedor basado en NMI (por ejemplo, Fort Point Payments).
Tener el módulo NMI instalado, junto con los módulos de reservas, TPV y zona de cliente.
Las credenciales de NMI: clave de seguridad de la API, clave de tokenización (collect.js) y Processor ID.
Para el cobro presencial, un datáfono/terminal compatible con NMI y su código de registro.
Permisos de administración/facturación para configurar.
Cómo se configura (paso a paso)
Paso 1 — Credenciales
Accede a Golfmanager con un usuario administrador.
Entra en NMI > Configuración.
Introduce la Clave de seguridad de la API (API Security Key).
Introduce la Clave de tokenización (collect.js).
Introduce el Processor ID (lo encuentras en tu portal NMI, en Settings → Transaction Routing).
Guarda los cambios. Las claves se almacenan cifradas.
Paso 2 — Datáfonos (solo para cobro presencial)
Entra en NMI > Dispositivos de pago.
Pulsa Añadir.
Introduce el código de registro del datáfono.
Introduce un nombre para identificarlo.
Guarda. El dispositivo quedará disponible para cobrar en el TPV.
⚠️ No hay un interruptor de "modo prueba/producción": el entorno lo determinan las propias claves. Usa primero las credenciales y datos de prueba que facilita NMI para validar el flujo y, cuando todo funcione, sustitúyelas por las credenciales reales.
Explicación de cada campo
A continuación se describe cada campo de la integración: dónde está, qué significa, su impacto en el sistema y un ejemplo de uso (qué ocurre cuando se utiliza y cómo se comporta el sistema).
A) Configuración (NMI > Configuración)
1. Clave de seguridad de la API (API Security Key)
Descripción: la clave privada de tu cuenta NMI (o de tu proveedor basado en NMI) con la que el servidor de Golfmanager autentica todas las operaciones.
Impacto en el sistema: es obligatoria para todo (online, presencial, preautorizaciones y devoluciones). Se guarda cifrada. Además, que sea una clave de prueba o de producción determina el entorno en el que operas.
Ejemplo de uso: la copias de tu portal NMI/proveedor y la pegas aquí.
Qué ocurre cuando se utiliza: se usa en cada cobro, preautorización, captura y devolución para autenticarse con NMI.
Comportamiento del sistema: si falta, al operar aparece "La clave de seguridad de NMI no está configurada" (o "NMI no está configurado") y no se realiza la operación.
2. Clave de tokenización (collect.js)
Descripción: la clave pública que carga el formulario seguro de tarjeta (Collect.js) en el navegador del cliente.
Impacto en el sistema: es obligatoria para el pago online; sin ella, el formulario de tarjeta no puede mostrarse. Se guarda cifrada.
Ejemplo de uso: la copias de tu portal NMI y la pegas aquí.
Qué ocurre cuando se utiliza: al iniciar un pago online, el formulario seguro se carga con esta clave y tokeniza la tarjeta (la convierte en un token).
Comportamiento del sistema: si falta, aparece "La clave de tokenización de NMI no está configurada".
3. Processor ID
Descripción: el identificador del procesador en NMI (lo encuentras en Settings → Transaction Routing de tu portal).
Impacto en el sistema: es obligatorio para el cobro presencial (datáfono), las preautorizaciones y la validación de tarjeta.
Ejemplo de uso: lo copias de tu portal NMI y lo pegas aquí.
Qué ocurre cuando se utiliza: se envía en las operaciones con datáfono para enrutar el cobro correctamente.
Comportamiento del sistema: si falta, aparece "El Processor ID de NMI no está configurado".
B) Dispositivos de pago (datáfonos)
4. Nombre del dispositivo
Descripción: el nombre con el que identificas el datáfono en Golfmanager.
Impacto en el sistema: te ayuda a elegir el datáfono correcto al cobrar (si tienes varios).
Ejemplo de uso: "Datáfono recepción" o "Datáfono bar".
Qué ocurre cuando se utiliza: aparece en la lista de dispositivos al iniciar un cobro presencial.
Comportamiento del sistema: si lo dejas vacío al registrar, aparece "Introduce el nombre del dispositivo".
5. Código de registro
Descripción: el código que vincula el datáfono físico con tu cuenta de NMI.
Impacto en el sistema: necesario para registrar el dispositivo; sin él, el lector no queda disponible para cobrar.
Ejemplo de uso: lo obtienes del datáfono o del portal NMI y lo introduces al añadir el dispositivo.
Qué ocurre cuando se utiliza: tras registrarlo, el datáfono queda disponible en el TPV para cobrar.
Comportamiento del sistema: si falta, aparece "Introduce el código de registro".
C) Métodos de pago
6. "NMI" (online) y "NMI In Person" (presencial)
Descripción: los dos medios de pago de la integración. NMI es para el pago online del cliente (zona de reservas/tienda) y NMI In Person para el cobro presencial en el TPV con datáfono.
Impacto en el sistema: deben estar activos para poder cobrar por cada canal. Ambos admiten devoluciones; "NMI In Person" admite además preautorización y captura.
Ejemplo de uso: te aseguras de que "NMI" aparece en el checkout online y "NMI In Person" en el TPV.
Qué ocurre cuando se utiliza: el cliente paga online con NMI, o el personal cobra con datáfono usando NMI In Person.
Comportamiento del sistema: si no aparece la opción, revisa que el método esté activo y que las credenciales necesarias estén configuradas (la tokenización para online; el Processor ID para presencial).
D) Tarjeta guardada del cliente
7. Tarjeta guardada (marca, últimos dígitos, tarjeta por defecto)
Descripción: la tarjeta tokenizada que el cliente decide guardar. Se muestra por su marca y sus últimos 4 dígitos (por ejemplo, "Visa ...4111"); una puede marcarse como tarjeta por defecto.
Impacto en el sistema: permite cobrar en el futuro sin volver a teclear la tarjeta. Golfmanager guarda solo una referencia segura (token), no el número completo.
Ejemplo de uso: estos datos no se rellenan a mano: se crean cuando el cliente marca "guardar tarjeta" al pagar (o cuando el personal tokeniza una tarjeta).
Qué ocurre cuando se utiliza: en el siguiente pago, el cliente (o el personal) puede elegir esa tarjeta guardada para cobrar.
Comportamiento del sistema: si un cliente no tiene tarjetas, al intentar usar este método aparece "El cliente no tiene tarjetas guardadas". Las tarjetas se consultan en NMI > Tarjetas.
Cómo se usa en el día a día (paso a paso)
Pago online y tarjeta guardada
El cliente realiza una reserva o una compra y elige NMI al pagar.
Introduce su tarjeta en el formulario seguro (o elige una tarjeta guardada, si la tiene).
Si marca "guardar tarjeta", quedará disponible para próximos pagos.
Al aprobarse, la venta queda marcada como pagada.
Pago presencial en el TPV
En el TPV, selecciona "NMI In Person".
Elige el datáfono de la lista.
El cliente acerca, inserta o pasa la tarjeta en el lector.
Espera la confirmación: Golfmanager consulta el resultado hasta que el cobro se completa.
Preautorización y captura
Para retener fondos (por ejemplo, una fianza), inicia una preautorización con el datáfono.
Más tarde, captura (cobra) el importe que corresponda —puede ser parcial— o cancela la retención si no procede.
Guardar una tarjeta sin cobro
Selecciona el cliente y el datáfono.
Inicia la validación de tarjeta (importe 0): el cliente presenta la tarjeta y queda guardada para futuros cobros, sin cargarle nada.
Devoluciones
Abre la venta a devolver.
Usa Opciones > Descartar (o la devolución correspondiente): Golfmanager envía a NMI la devolución de la transacción.
Comprueba en Transacciones que la devolución se ha registrado.
Se admiten devoluciones parciales y varias devoluciones sobre el mismo cobro (hasta el importe cobrado). Las devoluciones las realiza el personal, no el cliente.
Transacciones, tarjetas y dispositivos
En el menú de NMI dispones de:
Transacciones (NMI Transactions): el registro de todos los pagos, preautorizaciones, capturas y devoluciones, con su resultado (correcto o fallido), el importe, el cliente y el identificador de la transacción en NMI.
Tarjetas (NMI Cards): las tarjetas guardadas de los clientes (marca y últimos dígitos).
Dispositivos de pago: los datáfonos registrados.
Las transacciones son la primera pantalla a revisar cuando un cobro no se ha completado.
Limitaciones a tener en cuenta
El cobro presencial requiere un datáfono compatible con NMI, registrado en el módulo con su código de registro.
La tarjeta guardada depende de que el cliente haya aceptado guardarla (o de que el personal la haya tokenizado).
El cobro presencial es asíncrono: el sistema espera a que el cliente presente la tarjeta en el lector; puede tardar unos segundos.
Las devoluciones requieren la transacción original de NMI; las realiza el personal, no el cliente.
Depende de un servicio externo: si NMI (o tu proveedor) no está disponible, no se pueden procesar pagos en ese momento.
Necesitas las credenciales correctas (clave de API, tokenización y Processor ID) del entorno que uses.
Preguntas frecuentes
Al pagar aparece "NMI no está configurado". ¿Qué significa?
Faltan credenciales en la configuración. Entra en NMI > Configuración y comprueba que están la clave de seguridad de la API, la clave de tokenización y el Processor ID; complétalas y guarda.
Aparece "La clave de seguridad de NMI no está configurada", "La clave de tokenización…" o "El Processor ID…".
El mensaje indica exactamente qué credencial falta. Cada una se usa para algo: la clave de seguridad para todas las operaciones, la de tokenización para el formulario de pago online y el Processor ID para el cobro presencial. Rellena la que falte en NMI > Configuración.
No aparece NMI como opción de pago.
Revisa que el método de pago esté activo y que estén configuradas las credenciales necesarias: para el pago online se necesita la clave de tokenización; para el presencial, el Processor ID y al menos un datáfono registrado.
No aparece ningún datáfono al cobrar en persona.
No hay dispositivos registrados (aparece "No hay dispositivos de pago registrados"). Ve a NMI > Dispositivos de pago, pulsa Añadir e introduce el código de registro y un nombre del datáfono.
Al registrar un datáfono me pide el nombre o el código de registro.
Ambos son obligatorios. Aparecen "Introduce el nombre del dispositivo" o "Introduce el código de registro" si falta alguno. Completa los dos y guarda.
El pago presencial no se completa o se queda esperando.
El cobro presencial es asíncrono: el sistema espera a que el cliente presente la tarjeta en el lector. Comprueba que el datáfono está encendido y conectado, que el cliente acerca/inserta la tarjeta, y revisa el detalle en Transacciones. Si el cliente cancela en el terminal, verás "Pago cancelado en el terminal".
La tarjeta del cliente fue rechazada (por ejemplo, "Card Declined" o "Insufficient Funds").
Es la respuesta que devuelve NMI/el banco. Pide al cliente que lo reintente o use otra tarjeta. El texto exacto (denegada, CVV incorrecto, fondos insuficientes…) aparece en la transacción.
Aparece "Error al completar la operación. El cobro ya se ha realizado. Contacta con el centro."
Es un aviso prudente: puede que el cobro se haya realizado aunque la confirmación no haya llegado bien. Antes de reintentar, revisa en Transacciones si el pago consta como correcto, para no cobrar dos veces. Si tienes dudas, contacta con soporte.
El cliente no ve su tarjeta guardada.
Puede que no se guardara (no marcó "guardar tarjeta") o que no sea el mismo cliente. Que vuelva a pagar marcando "guardar tarjeta", o el personal puede guardarla mediante la validación de tarjeta. Si al usar el método aparece "El cliente no tiene tarjetas guardadas", es que no hay ninguna asociada.
¿Cómo guardo la tarjeta de un cliente sin cobrarle?
Con la validación de tarjeta: seleccionas el cliente y el datáfono, el cliente presenta la tarjeta con importe 0 y queda guardada para futuros cobros sin cargarle nada.
¿Qué es la preautorización y para qué sirve?
Es una retención de fondos (sin cobro definitivo), útil para fianzas o depósitos. Después puedes capturar (cobrar) el importe —total o parcial— o cancelar la retención para liberar los fondos.
¿Puedo capturar un importe distinto al preautorizado?
Sí. Al capturar puedes indicar el importe que corresponda (por ejemplo, añadiendo una propina o cobrando menos), siempre dentro de lo que permita la preautorización.
¿Se pueden hacer devoluciones parciales?
Sí. Puedes devolver una parte del importe e incluso hacer varias devoluciones sobre el mismo cobro, hasta el total cobrado. La transacción original lleva el control de lo ya devuelto.
Intento devolver y dice que falta el ID de transacción original o que debo cancelar el pago original.
La devolución necesita la transacción original de NMI. En pagos online, primero hay que cancelar el pago original; si el aviso es "No se puede reembolsar: falta el ID de transacción original de NMI", revisa la transacción y contacta con soporte (puede tratarse de un pago antiguo).
¿Cómo trabajo en pruebas antes de cobrar de verdad?
No hay un interruptor de prueba/producción: el entorno lo determinan las claves. Usa las credenciales y tarjetas de prueba de NMI para validar el flujo y, cuando todo funcione, sustituye las claves por las de producción.
¿Los datos de la tarjeta pasan por Golfmanager?
No. La tarjeta se introduce en el formulario seguro de NMI (o se lee en el datáfono) y se tokeniza. Golfmanager guarda solo una referencia segura (token), nunca el número completo.
Trabajo con un proveedor basado en NMI (como Fort Point Payments). ¿Qué credenciales uso?
Las que te facilite ese proveedor: la clave de seguridad de la API, la de tokenización y el Processor ID. La conexión con Golfmanager se hace por este mismo módulo NMI.
¿Dónde veo si un cobro ha fallado y por qué?
En NMI > Transacciones. Cada operación muestra si fue correcta o fallida, el importe, el cliente, el detalle del error y el identificador de la transacción en NMI. Es el primer sitio donde mirar ante cualquier incidencia.
Buenas prácticas recomendadas
Prueba primero con las credenciales de test de NMI antes de operar en real.
Si usas un proveedor basado en NMI (como Fort Point Payments), pídele a él la clave de API, la de tokenización y el Processor ID.
Usa la preautorización para fianzas/depósitos y captura solo lo que corresponda.
Da un nombre claro a cada datáfono para elegir el correcto al cobrar.
Ante un cobro fallido, revisa primero Transacciones: el detalle suele indicar la causa.