Modelos de conexión
El TPV Integrado agrupa sus transportes en dos modos de conexión. El modo SDK (USB / HTTP) atiende a un terminal en la misma red local o por cable. El modo Cloud2Cloud atiende a un terminal remoto, al que llegas a través de la nube de Getnet. Los mecanismos de transporte difieren, pero toda conexión expone el mismo comportamiento funcional mediante una instancia unificada de Connector.
| Modelo | Transporte | Método de creación | Uso típico | Consideración clave |
|---|---|---|---|---|
| SDK — USB / Serie | Enlace físico directo (serie) | CreateUsb | TPV junto al sistema de automatización; red nula o limitada | La desconexión del cable interrumpe el canal; se requiere restablecerlo |
| SDK — Red (HTTP) | Wi-Fi o Ethernet (HTTP) | CreateHttp | Misma red local; implementación más común | La estabilidad de la red y la lógica de reconexión son importantes |
| Cloud2Cloud | Mediado por la nube (remoto) | CreateCloud | Terminales remotos o distribuidos; sin acceso a la red local | Depende de un servicio de nube externo; maneja la latencia y la reconexión |
Modo SDK (USB / HTTP)
El modo SDK se conecta a un terminal en la misma red local o por cable. Ofrece dos transportes.
Conexión USB / serie
El modelo de conexión USB establece un enlace físico directo entre el sistema de automatización y el terminal TPV mediante una interfaz serie. Se usa cuando el TPV está físicamente cerca del sistema de automatización, cuando la conectividad de red está restringida o no disponible, o cuando se requiere una conexión dedicada y estable. La comunicación es directa punto a punto, sin depender de la infraestructura de red. Necesitas acceso local al dispositivo y permisos, y usas CreateUsb para inicializar la conexión. Las conexiones USB son sensibles a las interrupciones físicas: si se desconecta el cable, el canal se pierde y debes restablecerlo.
Conexión de red (HTTP)
El modelo de conexión de red usa HTTP sobre Wi-Fi o Ethernet para comunicarse con el terminal TPV. Es el modelo de implementación más común y se adapta a entornos donde el sistema de automatización y el terminal están en la misma red. La comunicación se ejecuta sobre la red local, admite IPv4 e IPv6 y usa CreateHttp para establecer la conexión, lo que permite una ubicación flexible de los dispositivos. La estabilidad de la red es crítica; las interrupciones temporales pueden requerir lógica de reconexión, sobre todo cuando hay parámetros de configuración involucrados.
Conexión Cloud2Cloud
La conexión Cloud2Cloud permite que el sistema de automatización controle un terminal que no alcanza en la red local. Tu backend envía comandos a la nube de Getnet, que los retransmite al terminal remoto en modo TPV Integrado. Usa CreateCloud para abrir el canal. No se requiere nombre de host ni puerto, porque la nube enruta cada comando al terminal registrado. Este modo se adapta a implementaciones remotas o distribuidas, donde el terminal y el sistema de automatización funcionan en ubicaciones diferentes. Las conexiones en la nube dependen de un servicio externo, así que planifica considerando la latencia y la reconexión.
Abstracción unificada del Connector
Independientemente del modelo de conexión que uses, siempre se devuelve una instancia de Connector, están disponibles las mismas funciones de operación del dispositivo, la lógica de negocio permanece intacta y el ciclo de vida de la comunicación es idéntico. Esta abstracción permite a los partners cambiar de modelo de conexión sin refactorizar la lógica de pago.
Elegir un modelo de conexión
La elección depende de las restricciones físicas de la implementación, de la disponibilidad y fiabilidad de la red, de los requisitos operativos y de seguridad, y de las necesidades de escalabilidad. Todos los modelos cumplen por completo la especificación del TPV Integrado y las bibliotecas de integración los admiten por igual.
Para conocer todos los detalles de los parámetros y ejemplos de cada tipo de conexión, consulta las guías de conexión específicas.
Siguientes pasos
- Consulta Arquitectura del TPV Integrado para ver cómo encaja el Connector en el flujo general.
- Sigue el Inicio rápido para ejecutar tu primer pago con HTTP u otro modelo.