Descripción general del TPV Integrado

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 para que las operaciones de pago se puedan iniciar, controlar y completar de manera 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, permitiendo que las operaciones de pago se inicien, controlen y completen de manera programática, sin interacción manual en el terminal.

A diferencia de un TPV autónomo, donde el operador ingresa manualmente los valores y navega por las pantallas, un TPV Integrado recibe comandos estructurados del sistema de automatización y 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 automáticamente la pantalla correspondiente, lo que 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 comunicación con el terminal TPV
  • Enviar comandos que inician operaciones relacionadas con los pagos
  • Manejar respuestas estructuradas devueltas por el terminal
En el dispositivo TPV, una Connector App recibe los comandos e inicia internamente la Payment App. Esta transición se produce sin interrupciones, 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, cerrando el ciclo de comunicación y manteniendo a ambos sistemas sincronizados.

Modos de integración compatibles

El TPV Integrado admite varias capas de transporte para la comunicación entre el sistema de automatización y el terminal:

  • HTTP (Wi-Fi / Ethernet) — usando CreateHttp
  • USB / Serie — usando CreateUsb
  • Cloud-to-Cloud — usando CreateCloud
Cada modo de integración produce una instancia de Connector que expone el mismo conjunto de funciones de operación del dispositivo.

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 utilizando uno de los métodos de creación compatibles.
  2. Validar conectividad con el Terminal — Ejecuta Polling para confirmar que el TPV está conectado y listo para recibir comandos.
  3. Ejecutar operaciones de negocio — Invoca operaciones del dispositivo como Sale, Refund, GetReports o PreAuthorization.
  4. Finalizar recursos — Llama a Close para liberar todos los recursos asignados por la biblioteca de integración.

El incumplimiento de este ciclo de vida puede resultar en operaciones rechazadas o comportamiento indefinido.

Siguientes pasos

Para comenzar la integración:

En esta página

Descripción general del TPV Integrado