Índice
¿Qué es esta integración?
La integración con el proveedor de pagos 2C2P permite a los clubes que operan con esta pasarela ofrecer pagos online de forma segura y eficiente. Además, es posible guardar tarjetas para futuros pagos y procesar reembolsos directamente desde Golfmanager.
Es especialmente útil en mercados como Asia, donde 2C2P es uno de los proveedores de referencia, y admite el pago con tarjeta y con código QR.
Para habilitar la integración es necesario instalar el módulo payment2C2P (desde el App Market o con la ayuda de soporte). Para su contratación y descarga, contacta con nuestro equipo de soporte.
¿Qué problema resuelve?
Permite cobrar online con tarjeta o QR de forma segura a los clubes que trabajan con 2C2P.
Agiliza al cliente habitual: puede guardar su tarjeta y pagar sin volver a teclearla.
Gestiona los reembolsos directamente desde Golfmanager (al instante desde el TPV, o de forma automática en cancelaciones de reservas).
Se integra de forma nativa con el entorno operativo de Golfmanager.
¿Qué permite hacer?
Función | Para qué sirve |
Pago online (tarjeta / QR) | El cliente paga directamente mediante 2C2P al reservar o comprar |
Guardar tarjeta | Almacena la tarjeta del cliente (token) para futuros pagos más rápidos |
Reembolsos | Devolver el importe de una reserva o venta cobrada con 2C2P |
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta el checkout (pago) de Golfmanager con la pasarela 2C2P:
El cliente es redirigido al entorno seguro de 2C2P, donde paga con tarjeta o QR.
2C2P procesa el cobro y devuelve el resultado a Golfmanager, que marca la venta como pagada.
Para devolver, Golfmanager solicita a 2C2P el reembolso.
🔒 Seguridad: los datos de la tarjeta se gestionan en 2C2P. Si guardas la tarjeta del cliente, Golfmanager almacena una referencia segura (token de cliente), no el número de tarjeta. Las claves secretas y los archivos de certificado se guardan cifrados y de forma privada.
Requisitos previos (antes de activar la integración)
Tener el módulo payment2C2P instalado.
Tener una cuenta de 2C2P de pruebas (sandbox) y/o de producción, con acceso al menú de Opciones del comerciante.
Generar el par de claves con tu equipo técnico: una clave privada (archivo
privatekey.pem) y su clave pública (certificadopublic_key_x509.pem).Tener a mano el Merchant ID, las claves SHA secretas (de prueba y de producción) y el certificado público de 2C2P.
Permisos de facturación para configurar.
Configuración en tu cuenta de 2C2P
Antes de configurar Golfmanager, prepara estos dos datos en tu cuenta de 2C2P (menú Opciones > PAYMENT RESULT URL):
Accede a tu cuenta de 2C2P (entorno de pruebas o de producción).
Ve a Opciones > PAYMENT RESULT URL.
Introduce en el campo "Frontend return URL" la dirección de tu Golfmanager terminada en
/2c2p/callback(por ejemplo, la dirección de tu club seguida de/2c2p/callback). Es la URL a la que 2C2P devuelve al cliente tras pagar.Pega en el campo "Server-to-server API - Public key" el contenido de tu clave pública (
public_key_x509.pem).Guarda los cambios en 2C2P.
⚠️ Si la Frontend return URL no es correcta, el cliente no volverá bien a Golfmanager tras pagar y el pago podría quedar sin confirmarse. Confírmala con tu equipo de IT.
Configuración en Golfmanager (paso a paso)
Accede a Golf Manager.
En el menú lateral, selecciona 2C2P.
Haz clic en Configuración.
Activa o desactiva el Modo de producción según vayas a operar en real o en pruebas.
Introduce el Merchant ID y la Moneda.
Introduce la Clave secreta de pruebas y la Clave secreta de producción.
Sube el archivo de Clave de certificado y el de Clave privada.
Guarda los cambios.
A continuación se explica cada campo en detalle.
Detalle de cada campo de configuración
Modo de producción
Descripción: interruptor que decide si la pasarela funciona en real (producción) o en pruebas (sandbox).
Impacto en el sistema: determina qué claves secretas se usan. Activado → claves y cobros de producción (dinero real). Desactivado → claves y entorno de pruebas (sin cargos reales).
Comportamiento: con el interruptor desactivado, los pagos se procesan contra el entorno de pruebas de 2C2P; al activarlo, todos los cobros pasan a ser reales.
Ejemplo de uso: durante la implantación, déjalo desactivado y realiza pagos de prueba con tarjetas de test; cuando todo funcione, actívalo para empezar a cobrar de verdad.
Merchant ID
Descripción: identificador único de tu comercio en 2C2P.
Impacto en el sistema: es lo que identifica tus cobros ante 2C2P; sin él no se pueden generar pagos.
Comportamiento: se envía en cada solicitud de pago a 2C2P.
Ejemplo de uso: en 2C2P, ve a Opciones > Información del Comerciante (Merchant Information), copia el valor del Merchant ID y pégalo en este campo.
Moneda
Descripción: la moneda en la que se procesan las transacciones.
Impacto en el sistema: todos los pagos se cobran en esta moneda; debe coincidir con la que tenga habilitada tu cuenta de 2C2P.
Comportamiento: se incluye en cada solicitud de pago. Valor por defecto: THB (baht tailandés).
Ejemplo de uso: si operas en Tailandia, déjala en THB; cámbiala por la moneda que admita tu cuenta si operas en otro mercado.
Clave secreta de pruebas
Descripción: la clave SHA secreta del entorno de pruebas de 2C2P.
Impacto en el sistema: firma y valida de forma segura las transacciones cuando el modo de producción está desactivado.
Comportamiento: el sistema la usa solo en modo prueba; se almacena cifrada.
Ejemplo de uso: en tu cuenta de pruebas de 2C2P, ve a Opciones > Claves del Comerciante (Merchant Keys / Secret Key), copia la clave SHA actual y pégala aquí.
Clave secreta de producción
Descripción: la clave SHA secreta del entorno real (producción).
Impacto en el sistema: firma y valida los cobros reales cuando el modo de producción está activado.
Comportamiento: el sistema la usa solo en modo producción; se almacena cifrada.
Ejemplo de uso: repite el paso anterior pero en tu cuenta de producción de 2C2P, y pega aquí la clave SHA de producción. Úsala únicamente para producción.
Clave de certificado
Descripción: el certificado público de 2C2P (archivo) que descargas de tu cuenta.
Impacto en el sistema: permite establecer una comunicación cifrada y de confianza entre Golfmanager y 2C2P.
Comportamiento: se usa para validar/cifrar los mensajes intercambiados con 2C2P; es un campo de tipo archivo, privado.
Ejemplo de uso: en 2C2P, ve a Opciones > Claves Públicas 2C2P (2C2P Public Keys), descarga el archivo del certificado y súbelo en este campo.
Clave privada
Descripción: tu clave privada (archivo
privatekey.pem), generada por tu equipo técnico.Impacto en el sistema: firma de forma segura las solicitudes que Golfmanager envía a 2C2P.
Comportamiento: funciona junto con el certificado para la comunicación segura; es un campo de tipo archivo, privado. No la compartas.
Ejemplo de uso: sube el archivo
privatekey.pemque generaste al crear el par de claves (el mismo del que sale la clave pública que pegaste en 2C2P).
⚠️ La clave privada y la clave pública son un par: la pública se carga en 2C2P y la privada en Golfmanager. Deben corresponderse, o la comunicación segura fallará.
Cómo se usa en el día a día
Pago online (tarjeta o QR)
El cliente realiza una reserva o compra y elige 2C2P como forma de pago.
Golfmanager lo redirige a 2C2P, donde paga con tarjeta o con código QR.
Al completarse, vuelve a Golfmanager.
Qué ocurre / comportamiento del sistema: Golfmanager prepara la solicitud con tu Merchant ID, el importe, la moneda y la referencia de la venta, y dirige al cliente a la pantalla de pago de 2C2P. Si el pago se aprueba, la venta queda marcada como pagada automáticamente; si se rechaza, la venta queda pendiente.
Guardar tarjeta
Al pagar, el cliente marca la opción "Guardar tarjeta para uso futuro".
En el siguiente pago, su tarjeta guardada aparece como opción.
Qué ocurre / comportamiento del sistema: al guardar la tarjeta, 2C2P devuelve un token de cliente (customerToken) que se asocia a su ficha. En futuros pagos, ese token se usa para no tener que volver a introducir la tarjeta. Puedes consultar los tokens en Golfmanager > 2C2P > Client Token (Customer Token).
Reembolsos
Desde el TPV (Opciones > Descartar): el reembolso se solicita a 2C2P al instante, la venta se marca como cancelada y se genera una venta de "Cancelación". Admite devoluciones parciales.
Cancelación desde el portal de clientes: la reserva se cancela de inmediato, la venta permanece activa, y un proceso automático (cron job) ejecuta el reembolso más tarde.
Cancelación desde la vista interna de reservas: igual que el portal: reserva cancelada al momento y reembolso automático después.
Qué ocurre / comportamiento del sistema: en las cancelaciones de reservas (portal e interna), no hay que hacer nada más: la tarea programada comprueba las reservas canceladas pagadas con 2C2P y procesa el reembolso automáticamente. En el TPV, en cambio, el reembolso es inmediato al descartar la venta.
Transacciones y tarjetas guardadas
En el menú 2C2P dispones de:
Transacciones (Transaction): el historial de todos los pagos y reembolsos, con su resultado. Es la primera pantalla a revisar cuando un cobro o una devolución no han salido como esperabas. (Golf Manager > 2C2P > Transaction)
Token de cliente (Client Token): las tarjetas guardadas de los clientes. (Golf Manager > 2C2P > Client Token)
Limitaciones a tener en cuenta
Los reembolsos de cancelaciones de reservas no son inmediatos: se procesan automáticamente con la tarea programada (no requieren intervención manual). Solo el reembolso desde el TPV es inmediato.
Requiere el módulo payment2C2P y una cuenta de 2C2P con sus claves, certificado y la Frontend return URL configurada.
Es un pago online (no para el TPV físico con datáfono): el cliente paga en el entorno de 2C2P.
Pensada para mercados donde se usa 2C2P y para operar en THB u otras monedas habilitadas en tu cuenta.
Las claves de prueba y producción son distintas: recuerda activar el modo de producción para cobrar de verdad.
Depende de 2C2P: si el servicio no está disponible, no se pueden procesar pagos en ese momento.
Beneficios
Pagos online seguros y rápidos, con tarjeta o QR.
Posibilidad de guardar tarjetas para pagos futuros.
Compatible con reembolsos automáticos desde reservas y reembolsos inmediatos desde el TPV.
Integración nativa con el entorno operativo de Golfmanager.
Ideal para clubes que operan con THB u otras monedas configuradas en 2C2P.
Preguntas frecuentes
¿En qué se diferencia 2C2P de cobrar con un datáfono en el TPV?
2C2P es un pago online: el cliente paga en el entorno seguro de 2C2P (con tarjeta o con código QR), no con un datáfono físico del club. Se usa al reservar o comprar por internet, y al terminar el cliente vuelve a Golfmanager con el pago confirmado.
¿Qué necesito tener listo para empezar a usarlo?
Necesitas: el módulo payment2C2P instalado; una cuenta de 2C2P (de pruebas y/o producción); el par de claves que genera tu equipo técnico (clave privada privatekey.pem y su clave pública); y los datos de tu cuenta de 2C2P: Merchant ID, claves SHA secretas (prueba y producción) y el certificado público. Además, en 2C2P hay que configurar la Frontend return URL y pegar tu clave pública.
¿Dónde se configura todo? ¿Hay que tocar algo en 2C2P y algo en Golfmanager?
Sí, en los dos sitios. En 2C2P (Opciones > PAYMENT RESULT URL) se configura la Frontend return URL (terminada en /2c2p/callback) y se pega tu clave pública. En Golfmanager (menú 2C2P > Configuración) se introducen el Modo de producción, el Merchant ID, la Moneda, las claves secretas y los archivos de certificado y clave privada.
No aparece 2C2P como forma de pago. ¿Por qué?
Casi siempre es porque falta el módulo o la configuración. Comprueba que el módulo payment2C2P está instalado y que en 2C2P > Configuración están informados el Merchant ID, las claves y el certificado.
El cliente paga, pero la venta no se marca como pagada. ¿Qué reviso?
El punto más habitual es la Frontend return URL: debe ser la dirección de tu Golfmanager terminada en /2c2p/callback y estar bien escrita en 2C2P. Revisa también que has pegado correctamente la clave pública (Server-to-server) en 2C2P. Si esos datos no son correctos, el cliente paga pero el resultado no vuelve bien a Golfmanager.
El pago se rechaza. ¿Qué puede estar pasando?
Puede ser una tarjeta denegada por el banco del cliente o una clave del entorno incorrecta (por ejemplo, usar la clave de pruebas en producción). Revisa la clave secreta del entorno activo y consulta el detalle del intento en 2C2P > Transactions.
He cancelado una reserva pagada con 2C2P, pero el reembolso no aparece de inmediato. ¿Es normal?
Sí, es lo esperado. En las cancelaciones de reservas (desde el portal del cliente o desde la vista interna), la reserva se marca cancelada al momento, pero el reembolso se procesa automáticamente mediante una tarea programada que se ejecuta cada 12 horas. No tienes que hacer nada: se ejecuta solo. (El reembolso desde el TPV, en cambio, es inmediato.)
¿Para qué sirve el "Modo de producción" y por qué hay claves de prueba y de producción?
El Modo de producción decide si los cobros son reales (activado) o de prueba (desactivado, sandbox). Según esté, el sistema usa la clave secreta de producción o la de pruebas. Por eso debes rellenar ambas: la de pruebas para validar la integración sin cobrar de verdad, y la de producción para operar en real.
¿Qué diferencia hay entre la "clave privada" y la "clave de certificado"?
Son piezas distintas de la comunicación segura. La clave de certificado es el certificado público de 2C2P que descargas de tu cuenta y subes a Golfmanager. La clave privada es tuya (el archivo privatekey.pem que genera tu equipo) y forma pareja con la clave pública que pegas en 2C2P. La pública va en 2C2P y la privada en Golfmanager: deben corresponderse.
¿Qué moneda debo configurar?
La moneda que tenga habilitada tu cuenta de 2C2P. Por defecto viene THB (baht tailandés), por su uso habitual en Asia; cámbiala por la tuya si operas en otro mercado.
¿Cómo guarda el cliente su tarjeta y dónde puedo verla?
Al pagar, el cliente marca "Guardar tarjeta para uso futuro". Eso crea un token de cliente asociado a su ficha, que en próximos pagos le permite pagar sin volver a teclear la tarjeta. Puedes consultar esos tokens en Golf Manager > 2C2P > Client Token (Customer Token).
¿Cómo hago una devolución?
Depende de dónde canceles: desde el TPV, abre la venta y usa Opciones > Descartar y el reembolso se solicita al instante (admite devoluciones parciales). En las reservas (portal o vista interna), basta con cancelar: el reembolso se procesa automáticamente con la tarea programada.
¿Dónde consulto los pagos y los reembolsos realizados?
En Golf Manager > 2C2P > Transaction. Ahí ves el historial de pagos y reembolsos con su resultado; es la pantalla de referencia para revisar cualquier incidencia.
¿Qué ocurre exactamente, paso a paso, cuando un cliente paga?
Golfmanager prepara la solicitud de pago con tu Merchant ID, el importe, la moneda y la referencia de la venta, y redirige al cliente a la pantalla de pago de 2C2P. El cliente paga (tarjeta o QR) y vuelve a Golfmanager. Si 2C2P aprueba el pago, la venta se marca como pagada; si lo rechaza, la venta queda pendiente.
¿Puedo usar 2C2P para cobrar de forma presencial con datáfono?
No. 2C2P en esta integración es pago online. Para el cobro presencial con datáfono se usan otras integraciones de pasarela.
Estoy haciendo pruebas y me preocupa cobrar de verdad. ¿Cómo lo evito?
Mantén el Modo de producción desactivado: en ese estado todos los pagos van contra el entorno de pruebas de 2C2P y no hay cargos reales. Usa las tarjetas de prueba de 2C2P. Cuando todo funcione, activa el modo de producción para empezar a cobrar de verdad.