Worldpay (antes Vantiv, antes Mercury) es una integración heredada que se mantiene para comercios existentes. Soporta tres estilos de conexión: una terminal EMV VX 805 controlada por Datacap NETePay en Windows, Hosted Checkout en el navegador y el dispositivo de red IP Tran Cloud.

Esta es una integración heredada. Mercury Payment Systems pasó a llamarse Vantiv y hoy es Worldpay; PHP Point Of Sale ya no ofrece altas de nuevos comercios con este procesador. Si estás configurando el procesamiento de tarjetas por primera vez, usa PHP POS Payments — mira elegir un procesador de pagos. La integración sigue en el software, así que los comercios existentes de Worldpay / Vantiv / Mercury pueden seguir procesando, y todo lo que sigue les aplica.

La integración soporta tres estilos de conexión distintos, y el software elige el correcto automáticamente según lo configurado en la tienda y la caja:

Teléfonos del material de alta original: 800-846-4472 (ventas y servicio), 866-622-2390 (soporte técnico).

Elige la opción de procesador correcta

Abre Tiendas, haz clic en Editar junto a la tienda, abre la sección Integraciones y marca Activar procesamiento de tarjetas de crédito. En el menú Procesador de Tarjeta de Crédito hay dos entradas relacionadas:

• Worldpay (Formerly Vantiv/Mercury) — el riel original de Mercury/Vantiv. Elígelo si tu cuenta nació como Mercury o Vantiv. Es la única opción que además soporta Hosted Checkout e IP Tran Cloud.
• Worldpay — el riel EMV clásico de Worldpay. Elígelo si tu carta de alta vino de Worldpay directamente. Solo soporta el camino VX 805 + Datacap.

Tu hoja de configuración o el soporte técnico del procesador pueden confirmar en qué riel está tu cuenta de comercio. Todo lo demás del formulario de la tienda funciona igual en ambos.

Configuración de terminal EMV (VX 805 + Datacap NETePay)

Este es el camino de chip y PIN de mostrador. Requiere una máquina con Microsoft Windows junto a la terminal, y el software de Datacap debe estar corriendo en todo momento — si el listener o NETePay se cierran, el procesamiento de tarjetas se detiene.

1. Instala el paquete de software

1. Descarga el instalador de tu riel — el paquete Vantiv/Mercury o el paquete Worldpay — desde el enlace de tu material de alta, o pide a soporte la descarga vigente.
2. Haz doble clic en el ejecutable y sigue las instrucciones en pantalla. Los valores por defecto, incluido el directorio de instalación y el puerto del listener 3333, casi nunca necesitan cambiarse.
3. Reinicia la computadora al terminar el instalador. El software arranca solo tras el reinicio.

El paquete instala tres componentes: el controlador del dispositivo para la terminal VX 805, el listener dsiPDCX / dsiEMVUS de Datacap (el servicio local con el que habla el navegador) y el cliente NETePay de Datacap (que habla con el procesador).

Tu firewall debe permitir tráfico por el puerto 9000 para NETePay, y se requiere conexión a internet.

2. Configura NETePay

1. Haz doble clic en el icono de NETePay del escritorio si no está abierto.
2. En el primer arranque, NETePay pide obtener un número de serie del PSCS de Datacap (Payment Systems Configuration Server). Haz clic en Obtain Serial Number — se asigna automáticamente un número de serie de 10 dígitos. Haz clic en OK, y de nuevo OK en el diálogo que dice que aún no se han recuperado los parámetros del comercio.
3. Elige Setup → Merchant Parameters, haz clic en Load New Parameters y luego en Yes.
4. Haz clic en I have my DeploymentID e ingresa el Deployment ID que te dio el soporte técnico del procesador (o el soporte de PHP Point Of Sale), y haz clic en OK. Si nunca recibiste un Deployment ID, contacta a soporte para que primero se creen los parámetros del comercio en el servidor PSCS.
5. Verifica los datos demográficos del comercio que muestra NETePay. Si están mal, haz clic en Cancel y repite desde el paso 3; si están bien, haz clic en Yes, This is the Correct Merchant.
6. Haz clic en OK hasta volver a la ventana principal de estado. NETePay ya está listo para procesar.

3. Configura la tienda

1. Ve a Tiendas y haz clic en Editar junto a la tienda.
2. Marca Activar procesamiento de tarjetas de crédito y pon el Procesador de Tarjeta de Crédito en tu riel (mira arriba).
3. Ingresa el EMV Merchant ID / Terminal ID exactamente como aparece en tu hoja de configuración.
4. Deja el Puerto COM en su valor por defecto de 9 y el Puerto de escucha en su valor por defecto de 3333, salvo que tu instalador indicara otra cosa.
5. Deja Net E-Pay Server vacío salvo que NETePay corra en una máquina distinta a la de esta caja — en ese caso ingresa la dirección de esa máquina.
6. Deja Ignorar dispositivo EMV e Ignorar dispositivo no EMV vacíos salvo que tu hoja de configuración nombre una cadena de dispositivo (algunas altas usan valores como EMV_VX805_GLOBALPAY; los valores estilo TSYS están en configurar TSYS).
7. Haz clic en Guardar y luego en Inicializar el lector de tarjetas de crédito. La inicialización puede tardar uno o dos minutos; espera el mensaje de éxito antes de cobrar una venta.

Configuración de Hosted Checkout (pagos en el navegador, sin pin pad)

Hosted Checkout toma el pago en una ventana segura del navegador en vez de en un dispositivo EMV de mostrador. La tarjeta se ingresa tecleada o con un lector de banda USB MagTek. Dos cosas sobre cómo lo elige el software: los navegadores móviles usan siempre Hosted Checkout (este riel no tiene soporte EMV móvil), y los navegadores de escritorio caen a Hosted Checkout cuando el trío EMV Merchant ID / Puerto COM / Puerto de escucha no está relleno.

1. Genera la contraseña en el portal de Vantiv

1. Espera la carta de bienvenida que Mercury/Vantiv envía por correo; contiene tu User ID del portal. La contraseña llega en un correo aparte.
2. Inicia sesión en el portal de Vantiv Integrated Payments (portal.mercurypay.com).
3. Abre Account Settings.
4. En Hosted Checkout Password Management, selecciona la terminal que estás configurando y haz clic en Continue.
5. Haz clic en Generate Password y luego en Save al final — la contraseña no queda guardada hasta que guardas.

El portal también sirve para ver estados de cuenta mensuales, el historial completo de transacciones y los totales de lote por fecha y tipo de tarjeta, de una tienda o de toda la cadena.

2. Ingresa las credenciales en PHP Point Of Sale

1. Ve a Tiendas, haz clic en Editar junto a la tienda y marca Activar procesamiento de tarjetas de crédito con el procesador en Worldpay (Formerly Vantiv/Mercury).
2. Ingresa el Hosted checkout Merchant ID (Id. del comerciante).
3. Pega la contraseña generada en el campo de contraseña generada de Mercury. La nota del propio campo recuerda dónde vive: el área Account Settings del sitio de Mercury, en HostedCheckout Password Management.
4. Haz clic en Guardar. Ya puedes procesar tarjetas desde cualquier navegador.

Configuración de IP Tran Cloud (terminal de red compartida)

El dispositivo IP Tran Cloud se conecta a tu red para que cualquier equipo de esa red — un iPad, una tableta, una PC — pueda controlar una misma terminal de tarjetas. No necesita listener de Windows.

1. Conecta el hardware

1. Conecta el cable de corriente al dispositivo IP Tran.
2. Conecta un cable Ethernet entre el dispositivo IP Tran y tu router.
3. Conecta el cable serial entre el dispositivo IP Tran y la terminal de tarjetas.
4. Conecta el cable de corriente de la terminal al tomacorriente.

2. Configura la caja

1. Ve a Tiendas, haz clic en Editar junto a la tienda y marca Activar procesamiento de tarjetas de crédito con el procesador en Worldpay (Formerly Vantiv/Mercury).
2. En la tabla de Cajas registradoras, ingresa el IP Tran Device ID de la documentación del dispositivo en la fila de la caja que lo usará. No ingreses un merchant ID en el campo EMV salvo que Vantiv te lo pida específicamente.
3. En la columna Acciones del lector de tarjetas de esa fila, haz clic en Inicializar el lector de tarjetas de crédito. Puede tardar un par de minutos. El enlace Actualización de parámetros de la misma columna vuelve a descargar los parámetros del dispositivo cuando soporte lo pida.

Como el IP Tran Device ID vive en la caja, cada caja puede apuntar a su propio dispositivo.

Referencia de ajustes de tienda y caja

• Activar procesamiento de tarjetas de crédito — interruptor maestro del procesamiento integrado en esta tienda. Apagado por defecto.
• Procesador de Tarjeta de Crédito — el riel: Worldpay (Formerly Vantiv/Mercury) o Worldpay.
• EMV Merchant ID / Terminal ID — de tu hoja de configuración; rellenarlo (con los dos puertos) selecciona el camino EMV en escritorio.
• Puerto COM — por defecto 9.
• Puerto de escucha — por defecto 3333.
• Net E-Pay Server — solo si NETePay no se instaló en esta máquina.
• Tarjetas de regalo integradas — márcalo si tu cuenta de comercio incluye tarjetas de regalo del procesador; mira tarjetas de regalo.
• Ignorar dispositivo EMV / Ignorar dispositivo no EMV — cadenas de dispositivo; déjalos vacíos salvo que tu hoja nombre una. También existen por caja para hardware mixto.
• Hosted checkout Merchant ID / contraseña generada de Mercury — las credenciales de Hosted Checkout.
• Desactivar la confirmación del monto al procesar la tarjeta de crédito — omite la confirmación del monto antes de que la terminal tome el control.
• Utilizar EBT integrado — habilita pagos EBT por la terminal donde la cuenta lo soporte.
• Por caja: ID de terminal, Enable Tips (habilitar propinas), Ignorar dispositivo EMV / Ignorar dispositivo no EMV, IP Tran Device ID, Pin Pad IP, Pin Pad Port, y los enlaces de Acciones del lector de tarjetas (Actualización de parámetros / Inicializar el lector de tarjetas de crédito).

Editar tiendas requiere el permiso del módulo Tiendas en tu cuenta de empleado — mira permisos y plantillas. El procesamiento integrado también requiere que el punto de venta se sirva por HTTPS.

Solución de problemas de la terminal VX 805

Si Inicializar el lector de tarjetas de crédito falla con "No se puede inicializar el dispositivo", confirma primero que el listener de Datacap y NETePay están corriendo, que la terminal tiene corriente y que el cableado a la PC está intacto. Si aun así no inicializa, reconfigura la terminal para USB desde su menú de sistema:

1. Reinicia la terminal y presiona F2 y F4 juntos cuando aparezca la pantalla de arranque para entrar al System Menu.
2. Ingresa la contraseña Z66831 (presiona 1, alfa, alfa y luego 66831) y presiona la tecla verde Enter. En pin pads más nuevos de Vantiv teclea 166831.
3. En la pantalla VERIX TERMINAL MGR, presiona 2 (Edit Parameters).
4. En el aviso de GID 1 presiona la tecla verde Enter, ingresa la contraseña de nuevo y presiona Enter.
5. En la pantalla File Config Sys presiona la tecla verde Enter.
6. Presiona 1 para NEW, ingresa COMMPORT como parámetro, presiona Enter y dale el valor U (el valor 1 significaría serial), luego presiona Enter.
7. Presiona 1 para NEW otra vez, ingresa #CZE como parámetro, presiona Enter y dale el valor 1, luego presiona Enter.
8. Presiona la tecla roja Cancel para salir, presiona 1 para reiniciar el dispositivo y vuelve a inicializar desde el formulario de la tienda.

Si el pin pad deja de responder a media transacción ("sin respuesta del pin pad"), apaga y enciende la terminal, confirma que la máquina Windows no se durmió y vuelve a inicializar.

Compartir el internet de una PC con un lector Ethernet

Si un lector necesita conexión de red por cable y no hay puerto Ethernet libre cerca del mostrador, una PC con Windows puede compartir su propia conexión:

1. Haz clic en la barra de búsqueda abajo a la izquierda de Windows, escribe Panel de control y abre la aplicación.
2. En Redes e Internet, elige Ver el estado y las tareas de red.
3. Haz clic en Cambiar configuración del adaptador en el menú izquierdo.
4. Haz clic derecho en la conexión que la PC usa para internet (por ejemplo Wi-Fi) y elige Propiedades.
5. En la pestaña Uso compartido, marca Permitir que los usuarios de otras redes se conecten a través de la conexión a Internet de este equipo, elige el puerto Ethernet donde enchufarás el lector y haz clic en Aceptar.
6. Enchufa el lector a ese puerto Ethernet. Ahora recibe internet a través de la PC.

Después de configurar

Cobra una venta pequeña de prueba y paga con Tarjeta de crédito — la terminal (o la ventana de Hosted Checkout) despierta con el monto exacto. Los flujos del día a día — chip, sin contacto, banda, tarjetas en archivo, propinas, anulaciones, reembolsos y recuperación de transacciones sin confirmar — están en cobrar con tarjeta. Los conceptos compartidos de configuración (mapeo de cajas, HTTPS, puerta de enlace de respaldo) están en configurar el procesamiento de tarjetas.

Preguntas frecuentes

¿Worldpay / Vantiv / Mercury sigue soportado? La integración sigue funcionando para comercios existentes y sigue siendo seleccionable en el software, pero PHP Point Of Sale ya no ofrece altas nuevas con este procesador. Las tiendas nuevas deben usar PHP POS Payments.

¿Qué opción elijo — "Worldpay (Formerly Vantiv/Mercury)" o "Worldpay"? Elige Worldpay (Formerly Vantiv/Mercury) si tu cuenta nació como Mercury o Vantiv (y siempre que uses Hosted Checkout o IP Tran Cloud). Elige Worldpay si te diste de alta con Worldpay directamente en el riel EMV clásico.

¿Por qué mi iPad siempre abre una ventana de pago en el navegador en vez del pin pad? Los navegadores móviles siempre usan Hosted Checkout en este riel — no hay soporte EMV móvil. Para controlar una terminal real desde un iPad, usa el dispositivo IP Tran Cloud.

¿La PC con Windows tiene que estar encendida todo el tiempo? Para el camino de terminal EMV, sí: NETePay y el listener de Datacap deben estar corriendo siempre que cobres con tarjeta. Hosted Checkout e IP Tran Cloud no necesitan ningún software de Windows.

"No se puede inicializar el dispositivo" — ¿qué reviso primero? Que NETePay y el listener estén corriendo, que el Puerto COM coincida (por defecto 9), que el Puerto de escucha coincida (por defecto 3333), que el puerto 9000 esté abierto en el firewall y que la terminal tenga corriente. Luego sigue los pasos de la VX 805 de arriba para dejar el parámetro COMMPORT en USB.

Generé la contraseña de Hosted Checkout pero los pagos fallan con error de autenticación. Asegúrate de haber hecho clic en Save en el portal de Vantiv después de generarla — una contraseña sin guardar no está activa — y de que la contraseña pegada en el campo no lleve espacios al inicio o al final.

¿Pueden distintas cajas usar distintas terminales? Sí. Los ID de terminal, los IP Tran Device ID, los valores de IP/puerto del pin pad y los valores de dispositivo se configuran por caja en la tabla de Cajas registradoras del formulario de la tienda.

¿A dónde van los reembolsos y anulaciones? De vuelta por la misma integración a la misma tarjeta — ejecútalos desde la venta original. Mira cobrar con tarjeta.