Ir al contenido principal

v3 - Integración Worldpay

Pasarela Access Worldpay: cobros online con tarjeta, tarjetas guardadas, pago presencial con datáfono, cobros recurrentes y devoluciones desde Golfmanager. Qué es, instalación, configuración, campos, uso y preguntas frecuentes.

Índice

¿Qué es esta integración?

La integración con Worldpay conecta Golfmanager con la pasarela de pago Access Worldpay. Permite cobrar online con tarjeta, guardar la tarjeta del cliente para futuros pagos, cobrar de forma presencial con datáfono en el TPV, hacer cobros recurrentes (cuotas/membresías) y realizar devoluciones desde el propio sistema.

Una pasarela de pago es el servicio que conecta tu negocio con los bancos para cobrar con tarjeta de forma segura. Worldpay es una de las pasarelas más extendidas, muy habitual en el Reino Unido.

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

  • Mayor seguridad: los datos de la tarjeta los gestiona Worldpay; no se guardan en Golfmanager.

  • Devoluciones desde Golfmanager, sin entrar en el panel de Worldpay.

Modalidades de pago que ofrece

Modalidad

Para qué sirve

Pago online

El cliente paga con tarjeta al reservar o comprar online (zona de cliente)

Tarjeta guardada

Cobrar con una tarjeta que el cliente guardó previamente

Pago presencial (datáfono)

Cobrar en el TPV con el datáfono de Worldpay

Cobro recurrente

Cobrar automáticamente cuotas/membresías con la tarjeta guardada

Devolución

Reembolsar (total o parcial) una venta cobrada con Worldpay

¿Qué sistemas conecta y en qué dirección viajan los datos?

Conecta el checkout y el TPV de Golfmanager con Worldpay, en tiempo real:

  • En el pago online, el cliente introduce la tarjeta en el formulario seguro de Worldpay (los datos no pasan por Golfmanager).

  • En el pago presencial, Golfmanager envía el cobro al datáfono y recibe el resultado en directo.

  • Si se aprueba, la venta queda marcada como pagada. Para devolver, Golfmanager pide a Worldpay el reembolso.

🔒 Seguridad: los datos de la tarjeta se gestionan en Worldpay. Si guardas la tarjeta del cliente, Golfmanager almacena una referencia segura (token cifrado) y los últimos dígitos, nunca el número completo. Si un cobro online se aprueba pero falla algo después en el sistema, Golfmanager reembolsa automáticamente al cliente.

Requisitos previos (antes de activar la integración)

  1. Tener una cuenta de Worldpay (Access Worldpay). Si no la tienes, puedes pedir una cuenta de pruebas (sandbox) gratuita; las credenciales las facilita siempre el equipo de Worldpay.

  2. Tener el módulo Worldpay instalado, junto con los módulos de facturación y TPV.

  3. Los datos de tu cuenta Worldpay (usuario, contraseña, Checkout ID, Entity ID).

  4. Para el cobro presencial, un datáfono compatible con Worldpay y sus datos de activación.

  5. Permisos de facturación para configurar.

Cómo se instala

  1. Opción 1 — App Market: entra en el App Market, busca Worldpay e instala el módulo.

  2. Opción 2 — Instalación manual: tu equipo de implantación puede instalarlo desde la terminal. Si tienes dudas, escríbenos por la burbuja azul.

Cómo se configura (paso a paso)

Paso 1 — Datos de la cuenta Worldpay

Menú principal > Worldpay > Configuración de Worldpay

  1. Accede a Worldpay > Configuración de Worldpay.

  2. Introduce el Usuario y la Contraseña de tu cuenta (se guardan cifrados).

  3. Introduce el Checkout ID y el Entity ID.

  4. Indica la Moneda (por ejemplo, GBP o EUR) y el Nombre comercial (el nombre de tu empresa que verá el cliente).

  5. Selecciona las marcas de tarjeta aceptadas (Visa, Mastercard, Amex, etc.).

  6. Deja el Modo de Producción desactivado para hacer pruebas y guarda los cambios.

Paso 2 — Datáfono (solo para cobro presencial)

Menú principal > Worldpay > Dispositivos de pago

  1. Crea un nuevo dispositivo y dale un nombre reconocible (p. ej. "Datáfono recepción").

  2. Introduce los datos del datáfono que te facilita Worldpay (identificadores y código de activación).

  3. Pulsa "Create POS LicenseKey" para activarlo (obtiene su clave de acceso).

  4. Si más adelante caduca, usa "Update POS LicenseKey" para renovarla. Guarda los cambios.

⚠️ Recomendación: empieza con el Modo de Producción desactivado, haz un pago de prueba (online y, si aplica, con el datáfono) y actívalo solo cuando todo funcione.

Los campos de configuración en detalle

A continuación se explican los campos de la configuración de Worldpay.

1) Usuario

• Nombre del campo: Usuario

• Descripción: El nombre de usuario de la API que te facilita Worldpay.

• Impacto en el sistema: Identifica tu cuenta ante Worldpay; se guarda cifrado.

• Ejemplo de uso: lo copias del alta que te envía Worldpay.

  • Qué ocurre cuando se utiliza: autentica cada cobro o devolución.

  • Comportamiento del sistema: si es incorrecto, los pagos no se procesan.

2) Contraseña

• Nombre del campo: Contraseña

• Descripción: La contraseña de la API de tu cuenta. Es información sensible.

• Impacto en el sistema: Junto con el usuario, autentica la conexión; se guarda cifrada.

• Ejemplo de uso: la introduces al configurar la cuenta.

  • Qué ocurre cuando se utiliza: permite comunicarse con Worldpay.

  • Comportamiento del sistema: si es incorrecta, falla la autenticación.

3) Checkout ID

• Nombre del campo: Checkout ID

• Descripción: Identificador del formulario de pago (checkout) de Worldpay.

• Impacto en el sistema: Es el que carga el formulario seguro donde el cliente teclea la tarjeta online.

• Ejemplo de uso: lo copias del panel de Worldpay.

  • Qué ocurre cuando se utiliza: aparece el formulario de pago en la zona de cliente.

  • Comportamiento del sistema: sin él, el pago online no se puede mostrar.

4) Entity ID (Entidad)

• Nombre del campo: Entity ID

• Descripción: Identificador de la entidad/comercio en Worldpay.

• Impacto en el sistema: Indica bajo qué entidad se procesan los cobros.

• Ejemplo de uso: lo facilita Worldpay con tu cuenta.

  • Qué ocurre cuando se utiliza: los pagos se asocian a tu entidad.

  • Comportamiento del sistema: si es incorrecto, Worldpay rechaza las operaciones.

5) Moneda

• Nombre del campo: Moneda

• Descripción: La moneda en la que se cobran los pagos (p. ej. GBP, EUR).

• Impacto en el sistema: Determina la divisa de cada cobro.

• Ejemplo de uso: pones EUR si cobras en euros.

  • Qué ocurre cuando se utiliza: los importes se envían a Worldpay en esa moneda.

  • Comportamiento del sistema: debe coincidir con la moneda de tu cuenta Worldpay.

6) Nombre comercial (Trade name)

• Nombre del campo: Nombre comercial

• Descripción: El nombre de tu empresa que ve el titular de la tarjeta.

• Impacto en el sistema: Es lo que aparece asociado al cobro de cara al cliente.

• Ejemplo de uso: pones el nombre comercial de tu club.

  • Qué ocurre cuando se utiliza: el cliente reconoce el cargo por ese nombre.

  • Comportamiento del sistema: es informativo para el titular.

7) Modo de Producción

• Nombre del campo: Modo de Producción

• Descripción: Cambia entre el entorno de pruebas (sandbox) y el de cobros reales.

• Impacto en el sistema: Activado cobra de verdad; desactivado solo simula (sandbox).

• Ejemplo de uso: lo dejas desactivado al implantar y lo activas al validar.

  • Qué ocurre cuando se utiliza: en producción, las tarjetas se cargan realmente.

  • Comportamiento del sistema: usa las credenciales/entorno de pruebas o de real según el modo.

8) Marcas de tarjeta aceptadas

• Nombre del campo: Marcas de tarjeta aceptadas

• Descripción: Qué tipos de tarjeta admites (Visa, Mastercard, Amex, Diners, Discover, JCB, Maestro).

• Impacto en el sistema: Solo se aceptan las marcas marcadas.

• Ejemplo de uso: activas Visa y Mastercard si son las que admites.

  • Qué ocurre cuando se utiliza: el cliente puede pagar con esas marcas.

  • Comportamiento del sistema: una marca no marcada se rechaza.

9) Dispositivo de pago (datáfono)

• Nombre del campo: Dispositivo de pago (Worldpay > Dispositivos de pago)

• Descripción: Cada datáfono de Worldpay dado de alta, con su nombre y sus identificadores/código de activación.

• Impacto en el sistema: Es necesario para cobrar de forma presencial en el TPV.

• Ejemplo de uso: creas el datáfono, rellenas sus datos y pulsas "Create POS LicenseKey".

  • Qué ocurre cuando se utiliza: el TPV puede enviar cobros a ese datáfono.

  • Comportamiento del sistema: la clave de acceso se renueva con "Update POS LicenseKey" cuando va a caducar.

ℹ️ Nota: los nombres y la ubicación exacta de algunos ajustes pueden variar según tu versión. Tu equipo de implantación y Worldpay te facilitan los valores concretos.

Cómo se usa en el día a día

Pago online y tarjeta guardada

  1. El cliente elige Worldpay al pagar e introduce su tarjeta en el formulario de Worldpay.

  2. Si marca "guardar tarjeta", quedará disponible para próximos pagos y aparecerá entre sus tarjetas guardadas.

  3. Si ya tiene una tarjeta guardada, la selecciona sin volver a teclearla.

  4. Al aprobarse, la venta queda marcada como pagada.

Pago presencial en el TPV

  1. En el TPV, selecciona el cobro con Worldpay presencial y elige el datáfono.

  2. El importe aparece en el datáfono; el cliente inserta o acerca la tarjeta.

  3. Al aprobarse, la venta queda pagada y se puede imprimir el recibo.

Devoluciones

  1. Para devolver un pago online, abre la venta/reserva (por ejemplo, en Reservas > Ocupación) y cancela el pago: Golfmanager solicita a Worldpay el reembolso (total o parcial) y lo registra.

  2. Para una devolución presencial, hazlo desde el TPV con el datáfono; el cliente presenta la tarjeta y se imprime el recibo.

Pagos recurrentes y 3D Secure

  • Cobros recurrentes (cuotas/membresías): si el cliente guardó su tarjeta para suscripciones, Golfmanager puede cobrar automáticamente sin que el cliente tenga que estar presente, como alternativa o complemento a la domiciliación.

  • 3D Secure: es la verificación de seguridad del banco. En algunos pagos online, el cliente debe confirmar con un código (OTP) o contraseña en la página de su banco antes de completar el pago.

Transacciones, tarjetas y dispositivos

Menú principal > Worldpay

  • Transacciones de Worldpay: el registro de todos los pagos y devoluciones, con su resultado (correcto o el error). Es la primera pantalla a revisar cuando un cobro no se completa; las más recientes aparecen arriba.

  • Tarjetas guardadas (Worldpay cards): las tarjetas que el cliente ha guardado (marca y últimos dígitos), disponibles para pagos rápidos. Se pueden eliminar, pero no crear a mano.

  • Dispositivos de pago: los datáfonos dados de alta y su estado.

Limitaciones a tener en cuenta

  • Necesitas una cuenta de Worldpay y sus datos (las credenciales las da Worldpay).

  • El cobro presencial requiere un datáfono de Worldpay dado de alta.

  • Guardar tarjetas depende de que el cliente lo acepte.

  • Solo se aceptan las marcas de tarjeta que hayas configurado.

  • Algunos pagos requieren 3D Secure (confirmación del banco).

  • Depende de Worldpay: si el servicio no está disponible, no se pueden procesar pagos en ese momento.

Preguntas frecuentes

¿Worldpay sirve para cobrar online y también en mostrador?

Sí. Cubre el pago online en la zona de cliente, el pago presencial con datáfono en el TPV, el cobro con tarjeta guardada y los cobros recurrentes.

¿De dónde saco el usuario, la contraseña y el Checkout ID?

Los facilita el equipo de Worldpay al darte de alta. Si no tienes cuenta, puedes pedir una de pruebas (sandbox) gratuita.

¿Se guardan los datos de la tarjeta en Golfmanager?

No. Los datos sensibles los gestiona Worldpay. Si el cliente guarda su tarjeta, Golfmanager solo almacena una referencia segura (token) y los últimos dígitos.

No aparece Worldpay al pagar. ¿Por qué?

Suele faltar algún dato de la cuenta o el método no está activo. Revisa usuario, contraseña, Checkout ID y Entity ID del entorno activo (pruebas o producción).

El pago se rechaza.

Puede ser una tarjeta denegada, caducada, sin fondos o de una marca no aceptada. Revisa el detalle en Transacciones de Worldpay y las marcas aceptadas; el cliente verá un mensaje explicativo.

El pago presencial no se completa.

Comprueba que el datáfono esté dado de alta y activo, y que su clave de acceso no haya caducado (usa "Update POS LicenseKey" para renovarla).

Cobra de verdad en una prueba (o no cobra en real).

El Modo de Producción está mal puesto. Actívalo para cobros reales o desactívalo para pruebas.

¿Puedo hacer devoluciones desde Golfmanager?

Sí, totales o parciales, sin entrar en el panel de Worldpay. La devolución queda registrada como una transacción de tipo "Devolución".

¿Qué es 3D Secure y por qué me lo pide?

Es la verificación de seguridad del banco. En algunos pagos online el cliente confirma con un código (OTP) o contraseña. Es normal y aporta seguridad.

¿Puedo cobrar cuotas automáticamente con la tarjeta guardada?

Sí. Si el cliente guardó la tarjeta para suscripciones, se pueden hacer cobros recurrentes automáticos (cuotas/membresías).

¿Qué pasa si se cobra al cliente pero algo falla después?

Golfmanager reembolsa automáticamente el importe para que el cliente no quede cobrado sin su servicio, y deja registro del error.

¿Dónde veo todos los pagos?

En Worldpay > Transacciones de Worldpay: pagos, devoluciones y su resultado, con las más recientes arriba.

Buenas prácticas recomendadas

  • Prueba primero en modo sandbox antes de operar en real.

  • Guarda bien los datos de tu cuenta Worldpay y no los compartas; se almacenan cifrados.

  • Activa "guardar tarjetas" si quieres ofrecer pagos rápidos y cobros recurrentes a clientes habituales.

  • Renueva a tiempo la clave del datáfono ("Update POS LicenseKey") para evitar cortes en el cobro presencial.

  • Ante un pago fallido, revisa primero Transacciones: el detalle del error suele indicar la causa.

¿Necesitas ayuda?

Para la instalación, la configuración de la cuenta, el alta del datáfono o cualquier duda sobre los cobros, escríbenos en la burbuja azul de tu programa de gestión. Las credenciales de la cuenta y del datáfono las facilita el equipo de Worldpay.

¿Ha quedado contestada tu pregunta?