Getnet DocsGetnet Docs

Visão geral do POS 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

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. Assim, as operações de pagamento podem ser iniciadas, controladas e concluídas de forma programática.

O que é um POS Integrado

Um POS Integrado é um terminal de pagamento que se comunica diretamente com um sistema de automação comercial. Ele permite iniciar, controlar e concluir operações de pagamento de forma programática, sem interação manual no terminal.

Diferente de um POS autônomo, o operador não insere valores nem navega pelas telas manualmente. O POS Integrado recebe comandos estruturados do sistema de automação e retorna respostas estruturadas por um protocolo digital predefinido.

Se o sistema de automação não enviar um parâmetro opcional, o terminal exibe automaticamente a tela correspondente. Isso permite um fluxo totalmente ou parcialmente integrado, conforme os 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 a comunicação com o terminal POS
  • Enviar comandos que iniciam operações relacionadas a pagamento
  • Tratar as respostas estruturadas retornadas pelo terminal

No dispositivo POS, um Connector App recebe os comandos e inicia internamente o Payment App. Essa transição ocorre de forma transparente, sem interação do operador.

Quando o Payment App conclui a operação solicitada, o resultado retorna ao sistema de automação. Isso fecha o ciclo de comunicação e mantém os dois sistemas sincronizados.

Modos de conexão

O POS Integrado suporta dois modos de conexão. Ambos expõem a mesma instância de Connector e as mesmas operações de dispositivo — só o transporte até o terminal muda.

  • SDK (USB / HTTP) — o sistema de automação se conecta a um terminal na mesma rede local ou por cabo. Use CreateHttp para Wi-Fi ou Ethernet e CreateUsb para uma ligação serial.
  • Cloud2Cloud — o sistema de automação alcança um terminal remoto pela nuvem da Getnet. Use CreateCloud. Não é necessário acesso à rede local do terminal.

Cada modo produz uma instância de Connector que expõe o mesmo conjunto de funções de operação do dispositivo. A partir da criação do connector, os comandos e as regras de negócio são idênticos nos dois modos.

Ciclo de vida da comunicação

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

  1. Crie um Connector — Estabeleça um canal de comunicação usando um dos métodos de criação suportados.
  2. Valide a conectividade com o terminal — Execute o Polling para confirmar que o POS está conectado e pronto para receber comandos.
  3. Execute as operações de negócio — Invoque operações do dispositivo como Sale, Refund, GetReports ou PreAuth.
  4. Libere os recursos — Chame Close para liberar todos os recursos alocados pela biblioteca de integração.

Não respeitar esse ciclo de vida pode resultar em operações rejeitadas ou em comportamento indefinido.

Próximos passos

Para começar a integração: