Getnet DocsGetnet Docs

Descripción general del TPV Integrado

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page
Connect to CursorUse these docs in CursorConnect to VS CodeUse these docs in VS Code

Bienvenido a la documentación del TPV Integrado. Este modelo de integración permite que tu sistema de automatización comercial se comunique directamente con un terminal de pago Getnet. Así, las operaciones de pago se inician, se controlan y se completan de forma programática.

Qué es un TPV Integrado

Un TPV Integrado es un terminal de pago que se comunica directamente con un sistema de automatización comercial. Permite iniciar, controlar y completar las operaciones de pago de forma programática, sin interacción manual en el terminal.

A diferencia de un TPV autónomo, donde el operador ingresa los importes y navega por las pantallas de forma manual, un TPV Integrado recibe comandos estructurados del sistema de automatización. Devuelve respuestas estructuradas a través de un protocolo digital predefinido.

Si el sistema de automatización no envía un parámetro opcional, el terminal muestra la pantalla correspondiente de forma automática. Esto permite un flujo total o parcialmente integrado según los requisitos del sistema.

Arquitectura de alto nivel

En una arquitectura de TPV Integrado, el sistema de automatización comercial es responsable de:

  • Integrar la Integrated POS Library
  • Establecer la comunicación con el terminal TPV
  • Enviar comandos que inician operaciones relacionadas con los pagos
  • Procesar las respuestas estructuradas que devuelve el terminal

En el dispositivo TPV, una Connector App recibe los comandos e inicia internamente la Payment App. Esta transición ocurre de forma transparente, sin interacción del operador.

Una vez que la Payment App completa la operación solicitada, el resultado se devuelve al sistema de automatización. Así se cierra el ciclo de comunicación y ambos sistemas quedan sincronizados.

Modos de conexión

El TPV Integrado admite dos modos de conexión. Ambos exponen la misma instancia de Connector y las mismas operaciones del dispositivo; solo cambia el transporte hacia el terminal.

  • SDK (USB / HTTP) — el sistema de automatización se conecta a un terminal en la misma red local o por cable. Usa CreateHttp para Wi-Fi o Ethernet y CreateUsb para un enlace serie.
  • Cloud2Cloud — el sistema de automatización alcanza un terminal remoto a través de la nube de Getnet. Usa CreateCloud. No se requiere acceso a la red local del terminal.

Cada modo produce una instancia de Connector que expone el mismo conjunto de funciones de operación del dispositivo. Desde la creación del connector en adelante, los comandos y las reglas de negocio son idénticos en ambos modos.

Ciclo de vida de la comunicación

Cada interacción con un TPV Integrado debe seguir esta secuencia:

  1. Crear un Connector — Establece un canal de comunicación con uno de los métodos de creación compatibles.
  2. Validar la conectividad con el terminal — Ejecuta Polling para confirmar que el TPV está conectado y listo para recibir comandos.
  3. Ejecutar las operaciones de negocio — Invoca operaciones del dispositivo como Sale, Refund, GetReports o PreAuth.
  4. Liberar recursos — Llama a Close para liberar todos los recursos que asignó la biblioteca de integración.

Si no respetas este ciclo de vida, las operaciones pueden ser rechazadas o el comportamiento puede quedar indefinido.

Siguientes pasos

Para comenzar la integración: