# 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](/pt/integrated-pos/first-steps-pos/pos-architecture) para entender como o Connector se encaixa no fluxo geral.
* Siga o [Guia de Início Rápido](/pt/integrated-pos/first-steps-pos/quickstart-integrated-pos) para executar seu primeiro pagamento usando HTTP ou outro modelo.