El procesamiento de tarjetas se configura por tienda en Tiendas → Integraciones. Actívalo, elige el procesador, ingresa las credenciales del alta, asigna cada terminal a una caja en la pestaña Registros y terminales, e inicializa el lector antes de la primera venta real.

El procesamiento integrado de tarjetas es lo que hace que la caja envíe el total exacto a la terminal y traiga la aprobación directo a la venta. La configuración siempre ocurre en la tienda — no en Configuración — para que cada sucursal pueda operar su propia cuenta de comercio, procesador o flota de terminales.

Si todavía estás decidiendo qué procesador usar, empieza por elegir un procesador de pagos. Para PHP POS Payments Standard y Premium (terminales Valor y Equinox), la guía completa está en PHP POS Payments. Este artículo cubre el camino de configuración compartido, cada campo de las pestañas Integraciones y Registros y terminales, y un resumen de credenciales de cada procesador externo — las guías dedicadas por procesador están junto a este artículo en la sección de Pagos del Centro de ayuda.

El camino de configuración compartido

Necesitas el módulo Tiendas con la acción de permiso Agregar, actualizar. Para cualquier procesador los pasos son los mismos:

1. Ve a Tiendas y edita la tienda que cobrará con tarjeta.
2. Abre la pestaña Integraciones.
3. Marca Activar procesamiento de tarjetas de crédito. Aparece el desplegable Procesador de Tarjeta de Crédito.
4. Elige tu procesador en el desplegable.
5. Ingresa las credenciales de tu carta de alta o del panel del procesador (listas campo por campo más abajo).
6. Abre la pestaña Registros y terminales e ingresa el identificador de terminal de cada caja que cobre con tarjeta — ID de terminal, EPI de Valor o HSN de CardConnect según el procesador.
7. Haz clic en Guardar.
8. Para los procesadores de la familia Datacap, haz clic en Inicializar el lector de tarjetas de crédito y espera a que termine — la inicialización puede tardar uno o dos minutos.

Tu tienda siempre se sirve por HTTPS, que es lo que requiere el procesamiento integrado.

Todos los ajustes de la pestaña Integraciones

No todos los campos aplican a todos los procesadores — el formulario muestra solo los que usa el procesador seleccionado.

• Activar procesamiento de tarjetas de crédito — interruptor maestro; al desmarcarlo la caja vuelve a la captura no integrada de Crédito/Débito. Desactivado de fábrica.
• Procesador de Tarjeta de Crédito — el procesador de esta tienda. La lista completa está en elegir un procesador de pagos.
• Disable Amount Confirmation when processing credit card (desactivar la confirmación del monto) — omite el paso de confirmar el monto en pantalla al enviar un cargo a una terminal EMV. Desactivado de fábrica.
• Usar EBT integrado — procesa los pagos EBT por la terminal en vez de registrarlos a mano. Requiere una cuenta de comercio con EBT habilitado. Desactivado de fábrica.
• Tarjetas de regalo integradas (familia Datacap) — agrega un tipo de pago Tarjeta de regalo integrada procesado por la terminal. Desactivado de fábrica.
• EMV Merchant ID / Terminal ID (familia Datacap) — el identificador de comercio de tu hoja de configuración.
• Puerto COM (familia Datacap) — puerto serial de la terminal; COM 9 es el predeterminado.
• Puerto de escucha (familia Datacap) — el puerto donde responde el servicio local de Datacap; el 3333 es el predeterminado.
• Net E-Pay Server (familia Datacap) — solo escribe un valor si NETePay no está instalado en la misma máquina que el navegador; indica el equipo que lo ejecuta.
• EMV Device Override / Non EMV Device Override (familia Datacap) — nombres de perfil de dispositivo que reemplazan el predeterminado del procesador. Cada procesador trae un valor razonable (por ejemplo, Worldpay usa EMV_VX805_WORLDPAY y Heartland EMV_IPP320_HEARTLAND); con Otro procesador EMV seleccionado estos dos campos son obligatorios porque no hay predeterminado. Tu hoja de alta indica qué escribir — las cuentas TSYS suelen usar EMV_VX805_TSYS con VX805XPI_CTLS.
• Inicializar el lector de tarjetas de crédito — botón que carga los parámetros en una terminal de la familia Datacap. Ejecútalo tras la primera configuración, tras cambiar de terminal y tras reinstalar NETePay.

Los campos de credenciales propios de cada procesador (ID de comercio, claves API, etc.) aparecen en el mismo panel y se listan por procesador abajo.

La pestaña Registros y terminales

Cada fila de caja asigna una terminal física a un carril. Las columnas que puedes ver, según el procesador:

Un punto de estado junto al nombre de cada caja indica si su terminal responde, en los procesadores que reportan estado. Debajo de la tabla, Registro a usar para captura manual y enlaces de pago elige qué credenciales de terminal se usan para pagos tecleados y enlaces de pago por correo.

PHP POS Payments (camino recomendado)

PHP POS Payments es el procesamiento de marca propia. Standard (opción "PHP POS Payments Standard") opera terminales Valor VP100 / VL110 con un ID de la aplicación Valor en la tienda y un Valor EPI + Clave de la aplicación Valor por caja. Premium (opción "PHP POS Payments Premium") opera dispositivos Equinox 6200 / 8500 con PHP POS Payments Merchant ID, API Key, Bearer Token y Signing Key en la tienda y un ID de terminal por caja, más un portal dentro de la app. El cableado del hardware y cada campo están en PHP POS Payments.

CardConnect

CardConnect entrega el hardware como parte del alta. Cuando recibas tu carta:

1. Activa el procesamiento y elige CardConnect como procesador.
2. Ingresa el Merchant ID exactamente como aparece.
3. Ingresa el Rest Username y Rest Password del alta.
4. En Registros y terminales, escribe el CardConnect HSN de cada terminal — visible en su pantalla — en la fila de su caja.

Soporte de CardConnect: 877-828-0720.

Square y Square Terminal

Existen dos caminos con Square:

• Square (móvil) — se empareja con la app móvil de PHP Point Of Sale y la app de Square en el mismo dispositivo. Elige Square, define el Código de moneda (predeterminado USD) y deja el Multiplicador para obtener el total en centavos en su valor predeterminado de 100 salvo que soporte indique otra cosa. En la venta, la app entrega el cobro a Square y regresa al punto de venta.
• Square Terminal — elige Square Terminal, haz clic en Connect To Square para autorizar con el inicio de sesión OAuth de Square, elige tu Square Location ID y, en cada fila de caja, usa el botón para obtener el ID del dispositivo e ingresa el código de emparejamiento en la Square Terminal cuando lo pida. Disconnect From Square revierte la autorización.

Stripe

Stripe se configura con las claves del panel de Stripe (Developers → API keys):

1. Activa el procesamiento y elige Stripe.
2. Define el Código de moneda (predeterminado usd; la lista de monedas admitidas de Stripe está enlazada desde el campo).
3. Pega la Stripe Secret Key y la Stripe Publishable Key (claves en vivo, no de prueba).
4. Para chip y sin contacto en mostrador, haz clic en Register Stripe Reader en cada fila de caja e ingresa el código de registro que muestra la pantalla del lector Stripe. Unregister Stripe Reader elimina el emparejamiento.

Sin lector Stripe Terminal, la captura usa un lector de banda MagTek USB o entrada manual.

Braintree

Braintree usa tres valores del panel de Braintree (Account → My User → API Keys):

1. Genera una clave API si aún no tienes una.
2. Activa el procesamiento, elige Braintree e ingresa el Merchant ID, la Public Key y la Private Key.

Este camino está pensado para banda o captura manual, no para un teclado EMV completo; usa un procesador EMV nativo cuando necesites chip y sin contacto en mostrador.

Worldpay (Vantiv / Mercury) y los demás procesadores Datacap

Varios procesadores comparten el mismo patrón de Windows + Datacap: una terminal EMV (Verifone VX 805 o compatible; Heartland usa la Ingenico iPP320), Datacap NETePay y su servicio de escucha local. El servicio debe seguir en ejecución siempre que cobres con tarjeta. La familia incluye Worldpay (Formerly Vantiv/Mercury), Heartland, EVO, Worldpay, First Data y Otro procesador EMV (usado para TSYS y altas compatibles con Datacap no listadas).

El esquema (la guía dedicada de cada procesador tiene las pantallas exactas):

1. Instala NETePay desde el enlace de tu carta de alta y reinicia cuando lo pida para que el servicio arranque. Permítelo en el firewall de Windows.
2. En NETePay, obtén un número de serie de Datacap PSCS cuando lo solicite y, en Setup → Merchant Parameters → Load New Parameters, elige I have my Deployment ID e ingresa el ID que te dé el soporte técnico de tu procesador.
3. En PHP Point Of Sale, activa el procesamiento, selecciona el procesador e ingresa el EMV Merchant ID / Terminal ID de tu hoja de configuración.
4. Deja el Puerto COM en 9 y el Puerto de escucha en 3333 salvo que tu instalador los haya cambiado.
5. Guarda y haz clic en Inicializar el lector de tarjetas de crédito; espera a que termine.

Hosted Checkout (Worldpay/Vantiv) no necesita terminal local: ingresa el Hosted checkout Merchant ID y la contraseña generada por Mercury creada en el portal de Vantiv Integrated Payments. IP Tran Cloud coloca un pequeño dispositivo en tu red para que varias estaciones compartan terminales: escribe cada IP Tran ID de dispositivo en la fila de la caja, deja el ID de comercio vacío salvo que Vantiv indique lo contrario, y usa los enlaces por caja Actualización de parámetros e Inicializar el lector de tarjetas de crédito.

Si la inicialización falla con "Unable to initialize device", confirma que el servicio está en ejecución, que el puerto COM coincide y que la terminal tiene corriente y camino de red o serial hacia la PC.

Después de configurar

1. Registra una venta pequeña de prueba — primero activa el modo de prueba desde el menú de la caja (Activar modo de prueba) para que nada llegue a tus informes.
2. Elige Tarjeta de crédito al pagar; la terminal debe encender con el monto para chip, sin contacto o banda.
3. Confirma que la aprobación queda en la venta y que el recibo muestra el pago con tarjeta, y desactiva el modo de prueba.

Los flujos diarios con tarjeta — firmas, tarjetas guardadas, preautorizaciones, anulaciones, reembolsos, captura manual, terminales trabadas — están en cobrar pagos con tarjeta. Propinas y pagos divididos, en tipos de pago, propinas y pagos divididos.

Solución de problemas

No aparece el desplegable de procesador. Marca primero Activar procesamiento de tarjetas de crédito — el desplegable y los campos de credenciales solo se muestran con esa casilla marcada.

"Unable to initialize device" en una configuración Datacap. El servicio no responde. Confirma que NETePay está en ejecución, que el firewall permite el puerto de escucha (3333 predeterminado), que el puerto COM coincide con la terminal (COM 9 predeterminado) y que la terminal tiene corriente.

Las tarjetas funcionaban ayer y hoy no (familia Datacap). Casi siempre la PC con Windows se reinició o se durmió y el servicio no volvió. Inicia NETePay y luego ejecuta Inicializar el lector de tarjetas de crédito desde la tienda.

¿Qué terminal se usa para los pagos tecleados? La de la caja seleccionada en Registro a usar para captura manual y enlaces de pago en la pestaña Registros y terminales.

¿Pueden dos cajas compartir una terminal? Escribe el mismo identificador de terminal en ambas filas. Con IP Tran Cloud de Worldpay ese es el modelo de diseño — el dispositivo IP Tran vive en la red local y varias estaciones lo alcanzan.

¿Debo volver a capturar credenciales en mi segunda sucursal? Sí. Cada tienda lleva su propio procesador, credenciales y asignación de cajas, incluso cuando ambas usan la misma cuenta de comercio.

¿Dónde apago el procesamiento? Desmarca Activar procesamiento de tarjetas de crédito en la tienda y guarda. Las ventas existentes conservan su historial de tarjeta; la caja simplemente registra pagos de Crédito/Débito sin hablar con una terminal.