Índice
¿Qué es esta integración?
La integración con CardNet conecta Golfmanager con la pasarela de pago CardNet, el principal procesador de pagos con tarjeta de República Dominicana. Permite que tus clientes paguen online con tarjeta de crédito o débito al hacer una reserva o una compra.
Además de los pagos puntuales, la integración permite guardar la tarjeta del cliente de forma segura para cobros futuros (por ejemplo, cuotas de socio o pagos recurrentes), sin tener que volver a pedir los datos cada vez.
Una pasarela de pago es el servicio que conecta tu negocio con los bancos para cobrar con tarjeta de forma segura. CardNet es la pasarela de referencia en República Dominicana. Golfmanager le manda el importe y un token de la tarjeta, y ella se encarga de cobrar.
¿Qué problema resuelve?
Permite cobrar online con tarjeta a clubes que operan con CardNet, sin gestiones manuales.
Aumenta la seguridad: los datos de la tarjeta se introducen en un formulario protegido de CardNet y no pasan por los servidores de Golfmanager.
Guarda la tarjeta para cobros recurrentes: ideal para cuotas de socio y pagos periódicos, que pueden cobrarse de forma automática.
Deja rastro de cada operación: cobros e intentos quedan registrados en una pantalla de transacciones.
Separa pruebas y cobros reales: un entorno de prueba y otro de producción, para validar todo antes de cobrar de verdad.
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta el checkout (pago) de Golfmanager con la pasarela CardNet, en tiempo real:
El cliente introduce la tarjeta en un formulario seguro de CardNet (una ventana de CardNet incrustada en la página), que la convierte en un código cifrado (token).
Golfmanager envía ese token y el importe a CardNet, que procesa el cobro y responde si se ha aprobado o rechazado.
Si se aprueba, la venta queda marcada como pagada automáticamente.
Para guardar la tarjeta, Golfmanager registra al cliente en CardNet (con su nombre, correo y teléfono) y CardNet devuelve un identificador para los cobros futuros.
¿Qué información se intercambia?
Información | Dirección | Para qué |
Datos del cliente (nombre, correo, teléfono) | Golfmanager → CardNet | Registrar al cliente para poder guardar su tarjeta |
Tarjeta convertida en token e importe a cobrar | Golfmanager → CardNet | Procesar el cobro de forma segura |
Resultado del cobro e identificador de la transacción | CardNet → Golfmanager | Confirmar el pago y dejar registro |
Tarjetas guardadas del cliente (marca, caducidad, últimos dígitos, estado) | CardNet → Golfmanager | Mostrar y elegir la tarjeta para cobrar |
🔒 Seguridad: el número completo de la tarjeta nunca llega a Golfmanager. El formulario de tarjeta lo gestiona directamente CardNet; Golfmanager solo recibe un token y el resultado del cobro. Las tarjetas guardadas viven en CardNet; Golfmanager solo guarda el identificador del cliente en CardNet para poder consultarlas.
Requisitos previos (antes de activar la integración)
Tener una cuenta de comercio en CardNet, con acceso de prueba y de producción.
Tener el módulo CardNet instalado en tu Golfmanager, junto con el módulo de facturación. Si no lo tienes, contacta con soporte.
Las credenciales que facilita CardNet: la dirección de la API, la clave pública y la clave privada (de prueba y de producción).
La moneda en la que se cobrará (por ejemplo, el peso dominicano).
Que los clientes tengan correo electrónico: CardNet lo necesita para registrarlos. Si falta, el sistema lo pedirá durante el pago.
Permisos adecuados: para configurar la integración y consultar las transacciones se necesita permiso de administrador de sistema / gestión de facturación.
Cómo se configura en Golfmanager (paso a paso)
La configuración tiene tres partes: los datos generales (moneda), las credenciales (de prueba y de producción) y el entorno (modo de producción).
Paso 1 — Abrir la configuración e indicar la moneda
Accede a Golfmanager con permiso de gestión de facturación.
Ve a Facturación > Configuración de CardNet (o busca "CardNet" en la configuración).
Indica la moneda en la que se realizarán los cobros.
Guarda los cambios.
Paso 2 — Introducir las credenciales de prueba
En el apartado de credenciales de prueba, introduce la API de prueba (la dirección del servicio de pruebas de CardNet).
Introduce la clave pública de prueba.
Introduce la clave privada de prueba (se guarda cifrada).
Guarda los cambios.
Paso 3 — Introducir las credenciales de producción
En el apartado de credenciales de producción, introduce la API de producción (la dirección del servicio real de CardNet).
Introduce la clave pública de producción.
Introduce la clave privada de producción (se guarda cifrada).
Guarda los cambios.
Paso 4 — Elegir el entorno con "Modo de producción"
Deja desactivado el Modo de producción (por defecto) mientras pruebas: se usan las credenciales de prueba y los pagos no son reales.
Cuando hayas validado todo, actívalo: se usan las credenciales de producción y los cobros son reales.
Guarda los cambios.
⚠️ Recomendación: empieza con el modo de producción desactivado, haz un pago de prueba y actívalo solo cuando todo funcione.
Detalle de cada campo de configuración
A continuación se explica, uno por uno, cada campo de la pantalla Configuración de CardNet: qué es, cómo afecta al sistema, cómo se comporta y un ejemplo de uso con lo que ocurre al utilizarlo.
Modo de producción
Nombre del campo: Modo de producción (Production Mode). Es un interruptor (activado/desactivado).
Descripción: decide si la integración trabaja en el entorno de prueba o en el de producción (real).
Impacto en el sistema: determina qué juego de credenciales (y qué dirección de CardNet) se usa. Es el interruptor entre "pagos de mentira" y "pagos de verdad".
Comportamiento del sistema: con el modo desactivado, Golfmanager usa la API y las claves de prueba; con el modo activado, usa la API y las claves de producción, donde los cobros a las tarjetas son efectivos.
Ejemplo de uso / qué ocurre: lo dejas desactivado, haces un pago de prueba y compruebas que todo va bien; luego lo activas y guardas. Desde ese momento, los clientes pagan de verdad.
Moneda
Nombre del campo: Moneda (Currency).
Descripción: la moneda en la que se realizan todos los cobros con CardNet.
Impacto en el sistema: se envía a CardNet en cada cobro. Debe coincidir con la que admite tu cuenta de comercio; si no, los cobros se rechazarán.
Comportamiento del sistema: se aplica a todas las operaciones por igual (no hay una moneda distinta por cobro).
Ejemplo de uso / qué ocurre: indicas la moneda de tu cuenta de CardNet (por ejemplo, el peso dominicano) y guardas. A partir de ahí, todos los cobros se envían en esa moneda.
API de prueba
Nombre del campo: API de prueba (test api).
Descripción: la dirección del servicio de pruebas (sandbox) de CardNet.
Impacto en el sistema: es el destino de las operaciones de prueba. Solo se usa con el modo de producción desactivado.
Comportamiento del sistema: Golfmanager se conecta a esta dirección para cargar el formulario de tarjeta y procesar los pagos de prueba.
Ejemplo de uso / qué ocurre: pegas la dirección del entorno de pruebas que te facilita CardNet y guardas. Con ella, los pagos de prueba se procesan contra el sandbox.
Clave pública de prueba
Nombre del campo: Clave pública de prueba (Test public key).
Descripción: la clave pública del entorno de pruebas, que usa el formulario de tarjeta de CardNet en el navegador.
Impacto en el sistema: permite cargar el formulario seguro de tarjeta de prueba. Al ser pública, puede aparecer en el navegador sin riesgo.
Comportamiento del sistema: se envía al formulario de pago del cliente para inicializar el formulario de CardNet en modo prueba.
Ejemplo de uso / qué ocurre: pegas la clave pública de pruebas. Sin ella, el formulario de tarjeta de prueba no carga.
Clave privada de prueba
Nombre del campo: Clave privada de prueba (Private Test Key).
Descripción: la clave secreta del entorno de pruebas, que autoriza las operaciones contra el sandbox.
Impacto en el sistema: es la "contraseña" que valida las peticiones de prueba ante CardNet. Sin ella o si es incorrecta, los pagos de prueba fallan.
Comportamiento del sistema: se guarda cifrada y se usa para autenticar las llamadas a la API de pruebas.
Ejemplo de uso / qué ocurre: pegas la clave privada de pruebas y guardas. Trátala como una contraseña aunque sea de pruebas.
API de producción
Nombre del campo: API de producción (production api).
Descripción: la dirección del servicio real de CardNet.
Impacto en el sistema: es el destino de los cobros reales. Solo se usa con el modo de producción activado.
Comportamiento del sistema: Golfmanager se conecta a esta dirección para los formularios y cobros reales.
Ejemplo de uso / qué ocurre: pegas la dirección del entorno real que te facilita CardNet y guardas. Con el modo de producción activado, los cobros se procesan contra el servicio real.
Clave pública de producción
Nombre del campo: Clave pública de producción (Production public key).
Descripción: la clave pública del entorno real, que usa el formulario de tarjeta de CardNet en el navegador.
Impacto en el sistema: permite cargar el formulario seguro de tarjeta real. Sin ella, el formulario de pago de producción no funciona.
Comportamiento del sistema: se envía al formulario de pago del cliente para inicializar el formulario de CardNet en modo producción.
Ejemplo de uso / qué ocurre: pegas la clave pública de producción. Con el modo de producción activado, es la que da servicio al formulario que ven tus clientes.
Clave privada de producción
Nombre del campo: Clave privada de producción (Private key of production).
Descripción: la clave secreta del entorno real, que autoriza los cobros reales.
Impacto en el sistema: autoriza los cobros de producción. Si falta o es incorrecta, las operaciones reales se rechazan.
Comportamiento del sistema: se guarda cifrada y se usa para autenticar las llamadas a la API real.
Ejemplo de uso / qué ocurre: pegas la clave privada de producción y guardas. Es imprescindible para cobrar de verdad; trátala como una contraseña y no la compartas.
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 CardNet como método de pago.
Si no tiene correo registrado, el sistema se lo pedirá (CardNet lo necesita para registrarlo).
Aparece un formulario seguro de tarjeta de CardNet. El cliente introduce la tarjeta (o elige una guardada) y pulsa Pagar.
Si el pago se aprueba, la venta queda marcada como pagada al instante.
Qué ocurre / comportamiento del sistema: el formulario convierte la tarjeta en un token en los servidores de CardNet; Golfmanager registra al cliente en CardNet (si no lo estaba), envía el token y el importe, y CardNet procesa el cobro. Si lo aprueba, la venta se marca como pagada y la operación queda registrada; si lo rechaza, se muestra el error (por ejemplo, "El pago ha fallado") y el cliente puede reintentar con otra tarjeta.
Este método está pensado para los pagos online del cliente, no para cobrar en el TPV físico.
Guardar la tarjeta y cobros recurrentes
El cliente puede guardar su tarjeta durante el pago. A partir de ahí, esa tarjeta guardada se puede usar para:
Cobros automáticos de cuotas y pagos recurrentes (por ejemplo, cuotas de socio).
Cobros directos desde administración sobre la tarjeta guardada del cliente, sin que tenga que volver a introducirla.
Para los cobros automáticos y directos, el cliente debe tener una tarjeta guardada y activa (habilitada) en CardNet. Una tarjeta recién guardada puede quedar pendiente de activación: CardNet envía un código de seguridad al correo del cliente que hay que introducir para habilitarla. Si la tarjeta no está habilitada, el cobro no se podrá realizar.
Cómo comprobar que funciona
Ve a Facturación > Configuración de CardNet y verifica que están rellenos la API, la clave pública y la clave privada de prueba, además de la moneda, con el Modo de producción desactivado.
Entra en la tienda/portal online, añade una reserva o un producto y ve a pagar.
Elige CardNet, completa el correo si te lo pide y usa una tarjeta de prueba de CardNet en el formulario seguro.
Comprueba que el pago se aprueba y la venta queda marcada como pagada.
Ve a CardNet > Transacciones y confirma que aparece el cobro como correcto.
Cuando todo funcione, rellena las credenciales de producción, activa el Modo de producción y guarda.
Consultar las transacciones
El menú CardNet incluye dos registros:
Transacciones de CardNet: todos los cobros enviados a la pasarela, con el cliente, el importe, el tipo, si fueron correctos o fallidos, el identificador de la operación y el detalle del error si lo hubo.
Registros del cliente (Frontend Logs): el detalle técnico de lo que ocurre en el formulario de pago del cliente (por ejemplo, cuándo se crea un token, se cargan tarjetas, se activa una o se intenta una compra). Útil para que soporte diagnostique un problema concreto durante el pago.
El listado de transacciones oculta por defecto los intentos en curso o incompletos (borradores), para que solo veas las operaciones cerradas. Son la primera pantalla a revisar cuando un pago no ha salido como esperabas.
Limitaciones a tener en cuenta
Es para pagos online del cliente (reservas, tienda y cobros recurrentes), no para cobrar en el TPV físico.
CardNet opera en República Dominicana; debes tener una cuenta de comercio válida con ellos.
El cliente necesita correo electrónico para poder ser registrado en CardNet; sin él, el cobro no puede completarse.
Las tarjetas guardadas pueden requerir activación: hasta que el cliente introduce el código que CardNet le envía por correo, la tarjeta no está habilitada para cobros automáticos.
Las devoluciones no se procesan desde esta integración: gestiónalas según el procedimiento acordado con CardNet.
Se cobra en una única moneda, la que esté configurada.
Las credenciales de prueba y de producción son distintas: recuerda activar el modo de producción para cobrar de verdad y no mezclar entornos.
Depende de un servicio externo: si CardNet no está disponible o tarda demasiado en responder, el pago falla en ese momento y se puede reintentar; no hay reintento automático.
Preguntas frecuentes
¿Sirve CardNet para cobrar en el TPV físico del club?
No. Esta integración está pensada para los pagos online del cliente (reservas, tienda online y cobros recurrentes). No aparece como forma de pago en el TPV físico del mostrador.
¿Es seguro? ¿Dónde introduce el cliente los datos de la tarjeta?
Sí. Los datos de la tarjeta se introducen en un formulario seguro de CardNet incrustado en la página, no en Golfmanager. La tarjeta se convierte en un token cifrado en los servidores de CardNet. El número completo de la tarjeta nunca pasa por Golfmanager.
¿Qué datos de la tarjeta guarda Golfmanager?
Golfmanager no guarda el número de la tarjeta. Las tarjetas guardadas viven en CardNet; Golfmanager solo conserva el identificador del cliente en CardNet, y consulta a CardNet cuando necesita mostrar las tarjetas (marca, caducidad y últimos dígitos) o cobrar. El token de cada tarjeta se obtiene de CardNet en el momento del cobro, no se almacena localmente.
¿Por qué me pide el correo del cliente al pagar?
Porque CardNet exige un correo electrónico para registrar al cliente y poder procesar el pago (y guardar la tarjeta). Si el cliente no tiene correo en su ficha, el sistema lo pide durante el pago. Solo rellena el correo si falta; no sobrescribe uno ya existente.
¿Qué pasa si el cliente no tiene correo electrónico?
El pago no se puede completar sin correo, porque CardNet lo necesita para registrar al cliente. El formulario pedirá el correo en ese momento; conviene que las fichas de cliente tengan correo para evitar interrupciones en el cobro.
¿Cómo se guarda la tarjeta de un cliente?
Durante el pago, el cliente puede guardar su tarjeta en CardNet. A partir de ahí, esa tarjeta queda asociada a su ficha de CardNet y se puede usar para cobros futuros sin volver a teclearla. Cada tarjeta guardada muestra su marca, caducidad, últimos dígitos y estado (habilitada o pendiente de activar).
¿Qué es el código de seguridad que le llega al cliente por correo?
Es el código de activación de CardNet. Cuando una tarjeta se guarda pero queda deshabilitada, CardNet envía un código al correo del cliente. El cliente debe introducir ese código para habilitar la tarjeta. Hasta que no esté habilitada, no se le podrá cobrar de forma automática con ella.
Al pagar me sale "Debes seleccionar una tarjeta". ¿Qué significa?
Que el cliente tiene tarjetas guardadas pero no ha elegido ninguna antes de pulsar Pagar. Debe seleccionar una tarjeta de la lista (o añadir una nueva) y, entonces, completar el pago.
¿Cómo funcionan los cobros recurrentes o las cuotas de socio?
Una vez el cliente tiene una tarjeta guardada y habilitada, Golfmanager puede cobrarle de forma automática (por ejemplo, las cuotas) o mediante un cobro directo desde administración, usando esa tarjeta sin que el cliente tenga que volver a introducirla. El cobro se procesa contra CardNet igual que un pago online.
¿Qué necesita un cliente para poder cobrarle automáticamente?
Tres cosas: estar registrado en CardNet (lo hace Golfmanager la primera vez que paga), tener una tarjeta guardada y que esa tarjeta esté habilitada. Si falta alguna, el cobro automático no se realiza y verás un aviso indicando qué falta.
Sale "El cliente no tiene una tarjeta guardada de CardNet". ¿Qué hago?
Significa que intentas un cobro recurrente o directo sobre un cliente que no tiene ninguna tarjeta guardada en CardNet. El cliente debe guardar primero una tarjeta (por ejemplo, en su próximo pago online) para poder cobrarle de esa forma.
Sale "El cliente no tiene una tarjeta de CardNet habilitada". ¿Qué significa?
El cliente tiene una tarjeta guardada, pero está pendiente de activar. Debe introducir el código de seguridad que CardNet le envió por correo para habilitarla. Una vez habilitada, ya se le podrá cobrar.
¿Puedo hacer devoluciones desde Golfmanager con CardNet?
No. Las devoluciones no se procesan desde esta integración. Si necesitas reembolsar a un cliente, debes gestionarlo según el procedimiento acordado con CardNet (por ejemplo, desde su propio panel o con su soporte).
Me aparece "CardNet no está configurado". ¿Qué reviso?
Faltan datos del entorno activo. Ve a Facturación > Configuración de CardNet y comprueba que están rellenas la API, la clave pública y la clave privada del entorno que estés usando (prueba o producción), además de la moneda. Completa lo que falte y guarda.
Sale "No se pudo registrar el cliente en CardNet". ¿Por qué?
Normalmente, porque faltan datos del cliente (lo más habitual, el correo) o porque CardNet rechazó el alta. Completa el correo del cliente y vuelve a intentarlo; en los registros del cliente (Frontend Logs) puedes ver el detalle de lo que devolvió CardNet.
Sale "El pago ha fallado". ¿Qué hago?
Quiere decir que CardNet no ha aprobado el cobro (tarjeta rechazada, fondos insuficientes o una regla de la pasarela). Abre CardNet > Transacciones y mira el detalle del error de esa operación: suele indicar el motivo. El cliente puede probar con otra tarjeta.
¿Para qué sirve el "Modo de producción"?
Es el interruptor que decide si la integración trabaja con dinero real o en pruebas. Desactivado, usa las credenciales de prueba (los pagos no son reales). Activado, usa las credenciales de producción y cobra de verdad. Empieza siempre desactivado y actívalo solo cuando lo hayas validado todo.
¿Cómo hago una prueba sin cobrar de verdad?
Deja el Modo de producción desactivado, rellena las credenciales de prueba y haz un pago en la tienda online con una tarjeta de prueba de CardNet. El pago se procesa contra el entorno de pruebas y no se cobra nada real.
Hice un pago en modo prueba, ¿se ha cobrado de verdad?
No. Cualquier pago hecho con el Modo de producción desactivado ocurre en el entorno de pruebas y no genera ningún cargo real. Para cobrar de verdad, rellena las credenciales de producción y activa el Modo de producción.
¿Dónde compruebo si un cobro ha salido bien?
En CardNet > Transacciones. Cada operación aparece con su cliente, importe, tipo, si tuvo éxito, el identificador y, si falló, el detalle del error. Es la pantalla de referencia para revisar cualquier incidencia.
¿Qué son los "Registros del cliente" (Frontend Logs)?
Son un registro técnico de lo que ocurre en el formulario de pago del cliente (cargar tarjetas, crear un token, activar una tarjeta, intentar una compra…). Sirven sobre todo para que soporte diagnostique un problema concreto durante el pago; no son necesarios en el uso normal.
En Transacciones no veo algunos intentos de pago. ¿Por qué?
El listado oculta por defecto los intentos en curso o incompletos (borradores), para mostrarte solo las operaciones cerradas. Es normal que un intento que el cliente no llegó a completar no aparezca en la vista por defecto.
¿Qué permisos necesito para configurar la integración y ver las transacciones?
Permiso de gestión de facturación / administrador de sistema. Con él puedes acceder a la configuración de CardNet y a los registros de transacciones.
¿Se guardan de forma segura las claves?
Sí. Las claves privadas (de prueba y de producción) se guardan cifradas en Golfmanager. La API y la clave pública no son secretos sensibles (la clave pública está pensada para usarse en el navegador), pero conviene tratar todas las credenciales con cuidado y no compartirlas.
¿En qué moneda se cobra?
En la moneda configurada en la pantalla de CardNet. Debe coincidir con la que admite tu cuenta de comercio; si no, CardNet rechazará el cobro. Todos los cobros usan esa misma moneda.
¿Qué pasa si CardNet no está disponible cuando un cliente intenta pagar?
Si la pasarela no responde o tarda demasiado, el pago falla en ese momento y el cliente puede reintentarlo. No hay reintento automático. Si el problema persiste, lo más probable es que sea una incidencia del lado de CardNet.
¿Soporta verificación adicional del banco (3D Secure)?
La verificación de seguridad la gestiona CardNet en su formulario. Además, para las tarjetas guardadas, CardNet utiliza su propio mecanismo de seguridad: el código de activación que envía al correo del cliente. Cualquier requisito adicional de autenticación se aplica desde CardNet, no desde Golfmanager.
He terminado las pruebas. ¿Cómo paso a cobrar de verdad?
Ve a Facturación > Configuración de CardNet, rellena las credenciales de producción (API, clave pública y clave privada reales), activa el Modo de producción y guarda. Haz un primer cobro real controlado para confirmar que todo funciona.
Buenas prácticas recomendadas
Prueba primero en modo test antes de activar producción, y haz un cobro de ejemplo.
Asegúrate de que los clientes tienen correo para evitar errores al registrar la tarjeta.
Pide a los clientes que activen su tarjeta guardada (con el código que reciben por correo) si vas a cobrarles cuotas recurrentes.
Guarda bien las credenciales de producción y no las compartas; las claves privadas se almacenan cifradas en Golfmanager.
Confirma que la moneda configurada coincide con la de tu cuenta de CardNet antes de empezar a cobrar.
Ante un pago fallido, revisa primero Transacciones y los registros del cliente: el detalle del error suele indicar la causa.