Visão Geral do POS Integrado

Bem-vindo à documentação do POS Integrado. Este modelo de integração permite que seu sistema de automação comercial se comunique diretamente com um terminal de pagamento Getnet para que as operações de pagamento possam ser iniciadas, controladas e concluídas programaticamente.

O que é um POS Integrado

Um POS Integrado é um terminal de pagamento que se comunica diretamente com um sistema de automação comercial, permitindo que as operações de pagamento sejam iniciadas, controladas e concluídas programaticamente, sem interação manual no terminal.

Diferente de um POS autônomo, onde o operador insere manualmente os valores e navega pelas telas, um POS Integrado recebe comandos estruturados do sistema de automação e retorna respostas estruturadas através de um protocolo digital predefinido.

Se um parâmetro opcional não for enviado pelo sistema de automação, o terminal exibe automaticamente a tela correspondente, permitindo um fluxo totalmente ou parcialmente integrado dependendo dos requisitos do sistema.

Arquitetura de Alto Nível

Em uma arquitetura de POS Integrado, o sistema de automação comercial é responsável por:

  • Integrar a Integrated POS Library
  • Estabelecer comunicação com o terminal POS
  • Enviar comandos que iniciam operações relacionadas a pagamento
  • Lidar com respostas estruturadas retornadas pelo terminal
No dispositivo POS, um Connector App recebe os comandos e inicia internamente o Payment App. Essa transição ocorre perfeitamente, sem interação do operador.

Uma vez que o Payment App conclui a operação solicitada, o resultado é retornado para o sistema de automação, fechando o ciclo de comunicação e mantendo ambos os sistemas sincronizados.

Modos de Integração Suportados

O POS Integrado suporta múltiplas camadas de transporte para comunicação entre o sistema de automação e o terminal:

  • HTTP (Wi-Fi / Ethernet) — usando CreateHttp
  • USB / Serial — usando CreateUsb
  • Cloud-to-Cloud — usando CreateCloud
Cada modo de integração produz uma instância de Connector que expõe o mesmo conjunto de funções de operação do dispositivo.

Ciclo de Vida da Comunicação

Toda interação com um POS Integrado deve seguir esta sequência:

  1. Criar um Connector — Estabeleça um canal de comunicação usando um dos métodos de criação suportados.
  2. Validar a conectividade com o Terminal — Execute o Polling para confirmar que o POS está conectado e pronto para receber comandos.
  3. Executar Operações de Negócio — Invoque operações do dispositivo como Sale, Refund, GetReports ou PreAuthorization.
  4. Finalizar Recursos — Chame Close para liberar todos os recursos alocados pela biblioteca de integração.

Deixar de respeitar este ciclo de vida pode resultar em operações rejeitadas ou em um comportamento indefinido.

Próximos Passos

Para iniciar a integração:

Nesta página

Visão Geral do POS Integrado