Arquitetura e Conectividade
Este documento detalha a estrutura arquitetônica Cloud-to-Cloud (C2C) usada para integrar o POS Integrado Getnet com o seu Software de Caixa externo. Ao utilizar uma API baseada em nuvem, este modelo abstrai as complexidades de hardware local e permite o gerenciamento remoto e seguro de transações.
O Modelo de Integração Cloud-to-Cloud (C2C)
O modelo C2C representa uma mudança de paradigma em relação às integrações locais tradicionais. Em vez de se comunicar diretamente com o terminal por meio de uma conexão física ou rede local, seu Software de Caixa roteia todos os comandos através de uma Cloud API segura.
Fluxo Arquitetônico de Alto Nível
O processo de comunicação segue um caminho estritamente definido desde a sua infraestrutura até o autorizador de pagamentos:
- Software do Lojista: Inicia uma solicitação por meio de uma API autenticada por JWT em um canal HTTPS criptografado.
- Cloudflare WAF: Atua como um Gateway de segurança, validando solicitações por meio de IP whitelisting ou uma API-KEY dedicada.
- Getnet Cloud (Plataforma Adcom): Recebe a solicitação e identifica o terminal de destino para rotear o comando.
- Terminal POS: Recebe a instrução da nuvem para iniciar o processo de pagamento.
Pilha de Componentes do Terminal
O terminal físico de POS não é meramente um leitor de cartão; ele executa uma sofisticada pilha de software interno projetada para manter uma conexão persistente e segura com a Getnet Cloud.
- G-Services: O serviço principal no dispositivo que valida a comunicação com a Getnet Cloud.
- Connector App: Atua como a ponte entre os comandos baseados em nuvem e os intents de hardware local.
- App de Pagos Getnet: O aplicativo de pagamento principal que interage com o cartão do usuário e se comunica diretamente com o Autorizador de Pagamentos via canais em conformidade com PCI.
Requisitos de Conectividade
Para garantir uma integração perfeita, você deve atender aos seguintes requisitos de infraestrutura:
Pré-requisitos Técnicos Mínimos
Nota: Proficiência em API: As equipes de desenvolvimento devem ter experiência no consumo de APIs baseadas em nuvem. Todas as comunicações devem ser realizadas via HTTPS para garantir a integridade dos dados.
- Estabilidade de Rede: Embora a API lide com o roteamento, o terminal requer uma conexão de internet estável para receber instruções dentro das janelas de timeout definidas.
Parâmetros de Conectividade
Ao mudar para o ambiente de produção, o método de conexão é determinado pela infraestrutura do seu servidor:
| Infraestrutura | Mecanismo de Segurança |
|---|---|
| Servidor com IP Fixo | O IP do seu servidor é adicionado ao whitelist do WAF. Nenhuma alteração de código é necessária para esta transição. |
| IP Variável/Dinâmico | Uma API-KEY exclusiva é configurada no WAF e deve ser incluída no header de cada solicitação de endpoint. |
Importante: A API da Getnet Cloud permanecerá aberta por até 5 minutos enquanto aguarda uma resposta do terminal antes de cancelar a operação devido a um timeout. Certifique-se de que seu backend possa lidar com conexões de longa duração para transações síncronas.
Próximos Passos
Agora que você entende o fluxo arquitetônico, pode explorar o modelo de identidade e a lógica de operação do serviço:
Nesta página
Arquitetura e Conectividade