Modelos de conexão
O POS Integrado agrupa seus transportes em dois modos de conexão. O modo SDK (USB / HTTP) atende um terminal na mesma rede local ou ligado por cabo. O modo Cloud2Cloud atende um terminal remoto, acessado pela nuvem da Getnet. Os mecanismos de transporte são diferentes, mas toda conexão expõe o mesmo comportamento funcional por meio de uma instância unificada do Connector.
| Modelo | Transporte | Método de criação | Uso típico | Consideração principal |
|---|---|---|---|---|
| SDK — USB / Serial | Ligação física direta (serial) | CreateUsb | POS ao lado do sistema de automação; rede inexistente ou limitada | A desconexão do cabo derruba o canal; é necessário restabelecer |
| SDK — Rede (HTTP) | Wi-Fi ou Ethernet (HTTP) | CreateHttp | Mesma rede local; implantação mais comum | Estabilidade da rede e lógica de reconexão são importantes |
| Cloud2Cloud | Mediado pela nuvem (remoto) | CreateCloud | Terminais remotos ou distribuídos; sem acesso à rede local | Depende de um serviço de nuvem externo; trate latência e reconexão |
Modo SDK (USB / HTTP)
O modo SDK conecta a um terminal na mesma rede local ou ligado por cabo. Ele oferece dois transportes.
Conexão USB / serial
O modelo de conexão USB estabelece uma ligação física direta entre o sistema de automação e o terminal POS por uma interface serial. Ele é usado quando o POS está fisicamente próximo ao sistema de automação. Também serve quando a conectividade de rede é restrita ou indisponível, ou quando você precisa de uma conexão dedicada e estável. A comunicação é ponto a ponto direta, sem dependência da infraestrutura de rede. Você precisa de acesso e permissões locais ao dispositivo e usa CreateUsb para inicializar a conexão. As conexões USB são sensíveis a interrupções físicas — se o cabo for desconectado, o canal é perdido e deve ser restabelecido.
Conexão de rede (HTTP)
O modelo de conexão de rede usa HTTP sobre Wi-Fi ou Ethernet para se comunicar com o terminal POS. Este é o modelo de implantação mais comum e atende ambientes em que o sistema de automação e o terminal estão na mesma rede. A comunicação ocorre na rede local, suporta IPv4 e IPv6 e usa CreateHttp para estabelecer a conexão, o que permite posicionar os dispositivos com flexibilidade. A estabilidade da rede é crítica; interrupções temporárias podem exigir lógica de reconexão, especialmente quando há parâmetros de configuração envolvidos.
Conexão Cloud2Cloud
A conexão Cloud2Cloud permite que o sistema de automação controle um terminal que ele não alcança na rede local. Seu backend envia comandos para a nuvem da Getnet, que os repassa ao terminal remoto em modo POS Integrado. Use CreateCloud para abrir o canal; não é necessário informar hostname nem porta, porque a nuvem roteia cada comando ao terminal registrado. Esse modo atende implantações remotas ou distribuídas, em que o terminal e o sistema de automação ficam em locais diferentes. As conexões em nuvem dependem de um serviço externo, então planeje a latência e a reconexão.
Abstração unificada do Connector
Independentemente do modelo de conexão usado, sempre é retornada uma instância de Connector, as mesmas funções de operação do dispositivo estão disponíveis, a lógica de negócio permanece inalterada e o ciclo de vida da comunicação é idêntico. Essa abstração permite que os parceiros troquem de modelo de conexão sem refatorar a lógica de pagamento.
Escolha um modelo de conexão
A escolha depende das restrições físicas de implantação, da disponibilidade e confiabilidade da rede, dos requisitos operacionais e de segurança, e das necessidades de escalabilidade. Todos os modelos são totalmente compatíveis com a especificação do POS Integrado e recebem o mesmo suporte das bibliotecas de integração.
Para detalhes completos de parâmetros e exemplos por tipo de conexão, consulte os guias de conexão específicos.
Próximos passos
- Veja a Arquitetura do POS Integrado para entender como o Connector se encaixa no fluxo geral.
- Siga o Guia de Início Rápido para executar seu primeiro pagamento usando HTTP ou outro modelo.