Arquitectura y Conectividad
Este documento detalla el marco arquitectónico Cloud-to-Cloud (C2C) utilizado para integrar el POS Integrado Getnet con su Software de Caja externo. Al utilizar una API basada en la nube, este modelo abstrae las complejidades del hardware local y permite la gestión remota y segura de las transacciones.
El Modelo de Integración Cloud-to-Cloud (C2C)
El modelo C2C representa un cambio de paradigma con respecto a las integraciones locales tradicionales. En lugar de comunicarse directamente con el terminal a través de una conexión física o red local, su Software de Caja enruta todos los comandos a través de una Cloud API segura.
Flujo Arquitectónico de Alto Nivel
El proceso de comunicación sigue una ruta estrictamente definida desde su infraestructura hasta el autorizador de pagos:
- Software del Comercio: Inicia una solicitud a través de una API autenticada con JWT sobre un canal cifrado HTTPS.
- Cloudflare WAF: Actúa como un Gateway de seguridad, validando las solicitudes a través de IP whitelisting o una API-KEY dedicada.
- Getnet Cloud (Plataforma Adcom): Recibe la solicitud e identifica el terminal de destino para enrutar el comando.
- Terminal POS: Recibe la instrucción desde la nube para iniciar el proceso de pago.
Pila de Componentes del Terminal
El terminal físico POS no es simplemente un lector de tarjetas; ejecuta una sofisticada pila de software interno diseñada para mantener una conexión persistente y segura con Getnet Cloud.
- G-Services: El servicio principal en el dispositivo que valida la comunicación con Getnet Cloud.
- Connector App: Actúa como puente entre los comandos basados en la nube y los intents del hardware local.
- App de Pagos Getnet: La aplicación de pago principal que interactúa con la tarjeta del usuario y se comunica directamente con el Autorizador de Pagos a través de canales compatibles con PCI.
Requisitos de Conectividad
Para garantizar una integración fluida, debe cumplir con los siguientes requisitos de infraestructura:
Prerrequisitos Técnicos Mínimos
Nota: Proficiencia en API: Los equipos de desarrollo deben tener experiencia en el consumo de APIs basadas en la nube. Todas las comunicaciones deben realizarse a través de HTTPS para garantizar la integridad de los datos.
- Estabilidad de la Red: Aunque la API maneja el enrutamiento, el terminal requiere una conexión a Internet estable para recibir instrucciones dentro de las ventanas de timeout definidas.
Parámetros de Conectividad
Al pasar a producción, el método de conexión lo determina la infraestructura de su servidor:
| Infraestructura | Mecanismo de Seguridad |
|---|---|
| Servidor de IP Fija | La IP de su servidor se añade al whitelist del WAF. No se requieren cambios de código para esta transición. |
| IP Variable/Dinámica | Se configura una API-KEY única en el WAF y debe incluirse en la cabecera de cada solicitud de endpoint. |
Importante: La API de Getnet Cloud permanecerá abierta durante un máximo de 5 minutos mientras espera una respuesta del terminal antes de cancelar la operación debido a un timeout. Asegúrese de que su backend pueda gestionar conexiones de larga duración para transacciones síncronas.
Próximos Pasos
Ahora que comprende el flujo arquitectónico, puede explorar el modelo de identidad y la lógica de operación del servicio:
En esta página
Arquitectura y Conectividad