TSYS es una integración heredada de la familia Datacap que se mantiene para comercios existentes. Se configura con la opción Otros procesadores EMV más dos valores de dispositivo — EMV_VX805_TSYS y VX805XPI_CTLS — sobre la configuración estándar VX 805 + NETePay en Windows.

Esta es una integración heredada. PHP Point Of Sale ya no ofrece altas de nuevos comercios con TSYS (hoy parte de Global Payments); las tiendas nuevas deben usar PHP POS Payments — mira elegir un procesador de pagos. La configuración de abajo sigue siendo válida para comercios existentes de TSYS.

TSYS usa el patrón Datacap clásico: un pin pad VeriFone VX 805 conectado a una PC con Microsoft Windows que corre Datacap NETePay y el listener dsiPDCX / dsiEMVUS. Ese software debe estar corriendo en todo momento — si se cierra, el procesamiento de tarjetas se detiene. Lo único que distingue a TSYS de los demás procesadores Datacap es el menú de procesadores: TSYS no tiene entrada propia, así que se selecciona Otros procesadores EMV y la terminal se identifica con dos cadenas de dispositivo. El hardware VX 805 viene de TSYS, no de la tienda de hardware de PHP Point Of Sale.

Instala el paquete de software

1. Descarga el paquete instalador de TSYS que corresponda a tu licencia de NETePay — hubo un paquete de compra y uno de renta. Los enlaces de cartas de alta viejas pueden estar caducos; pide a soporte la descarga vigente si el tuyo ya no funciona.
2. Haz doble clic en el ejecutable y sigue las instrucciones en pantalla. Los valores por defecto, incluido 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 VX 805, el listener dsiPDCX / dsiEMVUS de Datacap y el cliente NETePay de Datacap — estos dos últimos son los que se comunican con TSYS. Tu firewall debe permitir tráfico por el puerto 9000 y se requiere conexión a internet.

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 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 del soporte técnico de TSYS (o del soporte de PHP Point Of Sale), y haz clic en OK. Si nunca recibiste uno, 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. 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 está listo para procesar.

Configura la tienda

1. Ve a Tiendas y haz clic en Editar junto a la tienda que cobrará con tarjeta.
2. En la sección Integraciones, marca Activar procesamiento de tarjetas de crédito.
3. Pon el Procesador de Tarjeta de Crédito en Otros procesadores EMV — no hay entrada TSYS en el menú; los valores del siguiente paso son los que lo convierten en TSYS.
4. Ingresa EMV_VX805_TSYS en el campo Ignorar dispositivo EMV y VX805XPI_CTLS en el campo Ignorar dispositivo no EMV, exactamente como están escritos.
5. Ingresa el EMV Merchant ID / Terminal ID exactamente como aparece al inicio de tu hoja de configuración.
6. 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.
7. Deja Net E-Pay Server vacío salvo que NETePay corra en una máquina distinta a la de esta caja.
8. 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.

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.

Referencia de ajustes

• Activar procesamiento de tarjetas de crédito — interruptor maestro, apagado por defecto.
• Procesador de Tarjeta de Crédito — en Otros procesadores EMV.
• Ignorar dispositivo EMV — EMV_VX805_TSYS.
• Ignorar dispositivo no EMV — VX805XPI_CTLS.
• EMV Merchant ID / Terminal ID — de la hoja de configuración.
• Puerto COM — por defecto 9.
• Puerto de escucha — por defecto 3333.
• Net E-Pay Server — solo si NETePay está en otra máquina.
• Tarjetas de regalo integradas — solo si tu cuenta TSYS incluye tarjetas de regalo del procesador; mira tarjetas de regalo.
• Utilizar EBT integrado — EBT por la terminal donde la cuenta lo soporte.
• Desactivar la confirmación del monto al procesar la tarjeta de crédito — omite la confirmación antes de que la terminal despierte.
• Por caja en la tabla de Cajas registradoras: ID de terminal, Enable Tips (habilitar propinas), columnas de Ignorar dispositivo EMV / Ignorar dispositivo no EMV por caja (útiles con hardware mixto) y Acciones del lector de tarjetas.

Después de configurar

Cobra una venta pequeña de prueba y paga con Tarjeta de crédito; la VX 805 despierta con el monto exacto. Los flujos diarios de tarjeta — chip, sin contacto, banda, propinas, anulaciones, reembolsos, recuperación de transacciones sin confirmar — están en cobrar con tarjeta; los conceptos compartidos de configuración están en configurar el procesamiento de tarjetas.

Preguntas frecuentes

¿TSYS sigue soportado? Los comercios existentes de TSYS pueden seguir procesando mediante la opción Otros procesadores EMV, pero ya no se ofrecen altas nuevas. Las tiendas nuevas deben usar PHP POS Payments.

¿Por qué TSYS no aparece en el menú de procesadores? TSYS viaja por el camino Datacap genérico. Seleccionar Otros procesadores EMV e ingresar las dos cadenas (EMV_VX805_TSYS y VX805XPI_CTLS) es la forma soportada de configurarlo.

El chip funciona pero el sin contacto no (o al revés). Los dos valores se reparten el trabajo: EMV_VX805_TSYS maneja el chip EMV y VX805XPI_CTLS el camino no EMV / sin contacto. Revisa ambos campos por errores de tipeo — deben coincidir exactamente.

La inicialización falla con "No se puede inicializar el dispositivo". Confirma que NETePay y el listener están corriendo, que el Puerto COM es 9, que el Puerto de escucha es 3333, que el puerto 9000 está abierto en el firewall y que la terminal tiene corriente. Luego sigue el procedimiento de reinicio de la VX 805 en configurar Worldpay, Vantiv y Mercury — aplica a toda VX 805, incluida la de TSYS.

Las tarjetas dejaron de funcionar a media jornada. Casi siempre es la PC con Windows: NETePay o el listener se cerraron, o la PC se durmió o reinició. Reabre NETePay y haz clic en Inicializar el lector de tarjetas de crédito en la tienda antes de la siguiente venta.

¿Puedo usar TSYS en un iPad? No. Esta integración necesita el listener de Windows, así que es solo de escritorio. Para tabletas, mira PHP POS Payments.