PHP POS Payments es el procesamiento de marca propia. Standard opera terminales EMV Valor y Dejavoo; Premium agrega dispositivos Equinox y un portal en la app para lotes, terminal virtual, disputas y multimedia. Esta guía cubre hardware, cada campo de credenciales y la configuración de la tienda.

PHP POS Payments es el procesamiento de tarjetas de marca propia de PHP Point Of Sale. Viene en dos versiones — Standard y Premium — y ambas manejan la caja directamente: el total de la venta llega a la terminal, el cliente paga y la aprobación regresa a la venta automáticamente.

Si todavía estás comparando procesadores, empieza por elegir un procesador de pagos. El camino compartido de Tiendas → Integraciones que usan todos los procesadores está en configurar el procesamiento de tarjetas. Este artículo es la guía completa de Standard y Premium con el hardware actual y cada campo que vas a capturar.

Qué hacen ambas versiones

Standard y Premium cobran pagos EMV en una terminal física — chip, sin contacto y banda — y ambas se integran por completo con la caja. Los montos viajan a la terminal sin volver a teclear, las aprobaciones se adjuntan a la venta, y los reembolsos y anulaciones regresan por la misma integración. Ambas también admiten:

• Tarjetas guardadas — almacena una tarjeta como token seguro y cóbrala después (suscripciones, facturas, clientes frecuentes).
• Propinas — se activan por caja en la pestaña Registros y terminales; ver tipos de pago, propinas y pagos divididos.
• Un pago de Débito separado — aparece cuando Mostrar el tipo de pago con tarjeta de débito al realizar el procesamiento integrado de tarjetas de crédito está activo en Configuración (solo PHP POS Payments y Dejavoo lo reciben).
• Captura manual — marca Introduzca manualmente los datos de la tarjeta junto a los controles de pago para teclear una tarjeta en una sola venta cuando la tarjeta física no lea; las cajas Premium (y Dejavoo) también tienen el interruptor Usar entrada manual del menú de la caja para toda la sesión.
• Historial de transacciones dentro de la app — la página Ver / editar transacciones con tarjeta del menú de la caja para anulaciones y reembolsos.

La operación diaria en la caja está en cobrar pagos con tarjeta.

Hardware de Standard vs Premium

En el desplegable Procesador de Tarjeta de Crédito corresponden a tres opciones: PHP POS Payments Standard (hardware Valor), Dejavoo (hardware P1/P8) y PHP POS Payments Premium (hardware Equinox). Compara funciones y precios en la página de PHP POS Payments; las tarifas se cotizan por negocio.

Alta

1. Pide una cotización o inscríbete desde las páginas de PHP POS Payments (o pregunta a ventas).
2. Tras la aprobación recibes una carta de alta con las credenciales y los identificadores de terminal que capturarás en el punto de venta. Los comercios de Valor Standard también reciben un correo de Valor para crear su acceso al portal en online.valorpaytech.com. Guarda ambos.
3. El hardware llega por paquetería. Dale a cada terminal corriente y un camino de red (Wi-Fi, Ethernet o celular donde el modelo lo admita) antes de configurar el software.

Standard: conectar la terminal Valor a la red

VP100 (mostrador):

1. Apaga el dispositivo y voltéalo.
2. Para Ethernet, conecta el cable al puerto LAN, enciende de nuevo y toca el icono Connection en la pantalla de inicio.
3. Para Wi-Fi, enciende y elige Yes, Connect, selecciona el SSID de tu tienda, escribe la contraseña y confirma con OK en el teclado.
4. Para cambiar de tipo de conexión después, toca el icono Connection en la parte superior de la pantalla y elige Wi-Fi.

VL110 (portátil):

1. Para usar datos celulares (GPRS), voltea el dispositivo, quita la tapa trasera, inserta la SIM en la ranura inferior derecha y vuelve a colocar la tapa.
2. Enciende, toca el icono Connection y selecciona GPRS — o completa el asistente de Wi-Fi igual que en la VP100.

Standard: obtener tus credenciales de Valor

Las credenciales de Standard salen del portal de comercios de Valor:

1. Inicia sesión en online.valorpaytech.com con el acceso que Valor te envió por correo tras la aprobación.
2. Haz clic en My Settings en el menú izquierdo y luego en el botón API Keys arriba.
3. Haz clic en el botón más (+) para agregar un dispositivo y selecciona el EPI de esa terminal.
4. Marca la casilla 2FA y haz clic en Save.
5. Usa los iconos de copiar para guardar el App Id y la App Key — los pegarás en PHP Point Of Sale enseguida. Repite por cada terminal (cada EPI tiene su propia App Key).

Standard: configurar la tienda

1. En PHP Point Of Sale ve a Tiendas y edita la sucursal.
2. Abre la pestaña Integraciones.
3. Marca Activar procesamiento de tarjetas de crédito y elige PHP POS Payments Standard.
4. Ingresa el ID de la aplicación Valor (el App Id que copiaste). La Identificación del canal de anulación de Valor queda vacío salvo que soporte te dé un valor.
5. Abre la pestaña Registros y terminales.
6. En cada caja que cobre con tarjeta, escribe el Valor EPI y la Clave de la aplicación Valor de ese carril.
7. Haz clic en Guardar.

No hay paso de inicialización — las terminales Valor hablan directo con la nube. (El punto de estado junto a cada caja solo se muestra para terminales Premium y Dejavoo; en Standard la caja avisa que la terminal está sin conexión cuando intentas cobrar.)

Standard con hardware Dejavoo

Las terminales Dejavoo P1 y P8 son dispositivos Android: conecta la corriente, únete al Wi-Fi de la tienda desde los ajustes de la terminal (o conecta Ethernet en la P1; la P8 también admite celular) y confirma que la terminal aparezca en línea antes de emparejarla.

1. Edita la tienda, marca Activar procesamiento de tarjetas de crédito y elige Dejavoo.
2. Ingresa el Merchant ID de tu alta.
3. En Registros y terminales, escribe por caja el ID de terminal, la Clave de autenticación de Dejavoo y — si cobras pagos tecleados o en línea — el Token de comercio electrónico Freedom de tus materiales de alta.
4. Guarda.

La referencia completa de Dejavoo — captura manual, EBT, tarjetas guardadas, reembolsos y cada campo — está en configurar Dejavoo.

Premium: conectar la terminal Equinox a la red

• Equinox 6200 — terminal compacta orientada al cliente; los pasos de Wi-Fi vienen en un PDF con el dispositivo (guía Wi-Fi del 6200).
• Equinox 8500 — pantalla de cliente más grande; normalmente Ethernet. Si la terminal debe compartir la red de la PC en lugar de un contacto de pared, usa la Compartición de conexión a Internet de Windows: comparte el adaptador con internet de la PC hacia el adaptador Ethernet donde está conectada la 8500 (Panel de control → Centro de redes y recursos compartidos → propiedades del adaptador → Uso compartido).

Dale corriente a la terminal y confirma las luces de enlace o el estado de red en pantalla antes de capturar las claves Premium.

Premium: configurar la tienda

Las credenciales Premium las entrega PHP POS al darte de alta — no salen del portal de Valor.

1. Edita la tienda, abre Integraciones, marca Activar procesamiento de tarjetas de crédito y elige PHP POS Payments Premium.
2. Ingresa, exactamente como se te entregaron:
   • PHP POS Payments Merchant ID
   • PHP POS Payments API Key
   • PHP POS Payments Bearer Token
   • PHP POS Payments Signing Key
3. En Registros y terminales, escribe el ID de terminal de cada caja con dispositivo Premium.
4. Haz clic en Guardar.

Premium agrega comportamiento opcional en la terminal, todo en la misma pestaña Integraciones:

• PHP POS Payments Test Mode (modo de prueba) — ejecuta los cargos contra el entorno de prueba mientras verificas la configuración. Desactivado de fábrica; apágalo antes de ventas reales.
• Prompt For Loyalty / Prompt For Name / Prompt for E-Mail / Prompt For Phone Number — pide esos datos al cliente en la terminal durante el pago.
• Ask for missing information for existing customers — solo pregunta los datos que el registro del cliente aún no tiene.
• Terms & Conditions (términos y condiciones) — texto que se presenta en la terminal para firma del cliente; en la caja, la casilla Mostrar términos y condiciones junto a los controles de pago lo activa por venta.
• Pre Work Order Authorization Terms / Post Work Order Terms — términos que se firman en la terminal al crear o completar una orden de trabajo.

Premium: la puerta de enlace de respaldo

Una tienda Premium puede guardar una segunda vía de procesamiento para que las ventas con tarjeta continúen si la principal falla. En la pestaña Integraciones, llena los campos etiquetados (Backup Gateway) — PHP POS Payments Merchant ID, PHP POS Payments Consumer Key y PHP POS Payments Secret Key — y haz clic en Get Authorization Key para generar la PHP POS Payments Authorization Key; el campo de fecha registra cuándo se creó. La casilla Modo de prueba para puerta de enlace de respaldo? (así etiquetada en la aplicación) apunta al entorno de prueba.

En la caja, el cajero cambia de vía desde el menú con Use Backup Gateway y regresa con Disable Backup Gateway. El interruptor solo aparece cuando los campos de respaldo están llenos.

El portal Premium

Los comercios Premium tienen un portal dentro del punto de venta. Se abre desde la entrada Portal de pagos PHP POS del menú izquierdo (también en el menú de la caja) y lo ven los empleados con la acción de permiso de Ventas View/Edit Card Transactions:

• Historial de transacciones y lotes — busca transacciones, filtra por fecha y tipo, exporta a Excel y revisa cómo liquidan los lotes.
• Terminal virtual — teclea una tarjeta para pedidos por teléfono o correo, con recibo por correo electrónico.
• Anular, devolver y capturar — reversa un cargo, reembolsa un monto elegido o captura una preautorización cuando se conoce el monto final.
• Biblioteca multimedia y presentaciones — sube imágenes y arma presentaciones que se reproducen en la terminal entre pagos.
• Marca en la terminal — pon la imagen de tu tienda en el dispositivo del cliente, con horario si quieres.
• Preguntas de encuesta con resultados — pregunta en la terminal tras el pago y revisa las respuestas.
• Plantillas de términos con registro de firmas — administra los textos de términos y conserva quién firmó qué.
• Estados de cuenta, estadísticas, disputas y fondeo ACH — estados mensuales, estadísticas de transacciones, registros de contracargos y actividad de depósitos para conciliar.

Los comercios Standard (Valor) y Dejavoo tienen la página Ver / editar transacciones con tarjeta — lista de transacciones filtrada por fecha con ID de venta, monto, tarjetahabiente, tarjeta enmascarada, método de entrada y respuesta, con un botón Anular en los cargos del mismo día (total o parcial) y un botón Devolver en los cargos de días anteriores (ingresando el monto a reembolsar), más los filtros Cobrar, Reembolso, Reverso, Anular, Autorización previa, Captura e Inscribirse — y Premium agrega junto a ella la página Lotes de tarjetas.

Salir a producción

1. Registra una venta de prueba — con Premium, deja PHP POS Payments Test Mode activo para esto, o usa el modo de prueba de la propia caja — y elige Tarjeta de crédito: la terminal debe mostrar el monto para chip, sin contacto o banda.
2. Confirma que la aprobación queda en la venta y que el recibo muestra el pago con tarjeta.
3. Desactiva el modo de prueba y cobra un pago real.

Para el trabajo diario con tarjeta — firmas, tarjetas guardadas, preautorizaciones, anulaciones, reembolsos, terminales sin conexión — consulta cobrar pagos con tarjeta.

Preguntas frecuentes

¿Cuál es la diferencia práctica entre Standard y Premium? El hardware y el portal. Standard opera terminales Valor (y Dejavoo) con credenciales del portal de Valor; Premium opera dispositivos Equinox orientados al cliente, agrega multimedia, marca, encuestas y términos firmados en la terminal, e incluye el portal en la app con estados de cuenta, disputas, terminal virtual y actividad ACH.

¿De dónde salen mis credenciales? Standard: del portal de comercios de Valor (My Settings → API Keys) — un App Id y una App Key por EPI. Premium: PHP POS entrega el Merchant ID, la API Key, el Bearer Token y la Signing Key al darte de alta. Dejavoo: de tu carta de alta.

¿Debo hacer clic en Inicializar el lector de tarjetas de crédito? No — ese botón pertenece a la familia de servicio Datacap. Las terminales Valor, Dejavoo y Equinox se conectan solas a la nube; en Dejavoo y Equinox, el punto de estado de la pestaña Registros y terminales te dice si responden.

La caja dice que la terminal está sin conexión. ¿Ahora qué? Revisa primero la corriente y la red de la terminal. En Premium y Dejavoo el aviso de sin conexión ofrece Usar entrada manual para seguir vendiendo tecleando tarjetas; en Standard, marca Introduzca manualmente los datos de la tarjeta junto a los controles de pago. Las tiendas Premium con credenciales de respaldo también pueden cambiar con Use Backup Gateway.

¿Puedo cobrar EBT en estas terminales? Sí, donde tu contrato de comercio lo permita — marca Usar EBT integrado en la tienda. En Premium el pago integrado es solo EBT (sin pago separado de Efectivo EBT).

¿Por qué no aparece el botón de Débito en mi caja? Con procesamiento integrado, Débito solo aparece cuando Mostrar el tipo de pago con tarjeta de débito al realizar el procesamiento integrado de tarjetas de crédito está marcado en Configuración → Formas de pago — de lo contrario el cliente simplemente elige débito en la terminal.

¿Puedo apagar la captura de firma? Sí — Configuración → Recibo tiene Disable Signature Capture for PHP POS Credit Card Processing (desactivar la captura de firma para el procesamiento de PHP POS), además de las opciones generales de firma cubiertas en cobrar pagos con tarjeta.

¿A quién llamo si necesito ayuda? Preguntas de alta, hardware y credenciales: 1-800-827-7059, o contacta a soporte con la URL de tu tienda y el dispositivo Standard o Premium que estés configurando. Las cotizaciones viven en las páginas de PHP POS Payments y de cotización.