Descripción general de App2App
Bienvenido a la documentación de App2App, la solución de integración de Getnet para terminales Android. Esta tecnología ofrece una forma fluida, segura y eficiente de procesar pagos directamente en el hardware de Getnet.
App2App es un modelo de integración basado en Deeplinks y Android Intents. Permite que tu app de automatización inicie transacciones financieras enviando comandos a la Getnet Payment App.
App2App elimina la necesidad de integraciones complejas entre nubes para las transacciones con tarjeta presente. Tu software se comunica de forma local con la Getnet Payment App instalada en el mismo dispositivo.
El proceso de pago incluye la lectura de la tarjeta, el ingreso del PIN y la autorización. Cuando termina, la app de Getnet devuelve automáticamente el control y los metadatos de la transacción a tu aplicación.
Ventajas y beneficios clave
Integrar tu software con la Getnet Payment App mediante el modelo App2App ofrece varias ventajas estratégicas y técnicas. Estas ventajas optimizan el recorrido de pago tanto para el comercio como para el desarrollador. Al aprovechar la comunicación local, la integración garantiza un alto nivel de seguridad y eficiencia operativa.
-
El software pasa de forma fluida a la interfaz de pago. Los operadores no necesitan cambiar de aplicación de forma manual.
-
Todo el procesamiento crítico ocurre dentro del entorno seguro de Getnet, por lo que tu aplicación nunca maneja datos sensibles de la tarjeta.
-
Las transacciones son mucho más rápidas, porque la comunicación local entre apps elimina la dependencia de la latencia de internet para el intercambio interno de datos.
-
El envío automático de los importes elimina los errores de ingreso manual y garantiza una precisión total durante el cobro.
-
Puedes usar la impresora integrada del terminal a través de la app de Getnet o recibir los datos en bruto para generar tus propios comprobantes personalizados.
Cómo funciona
El modelo de integración App2App permite una comunicación fluida entre dos aplicaciones Android distintas mediante Intents. Con este mecanismo, tu software inicia comandos de pago específicos dentro de la Getnet Payment App, encapsulados en objetos de solicitud predefinidos.
-
Solicitud: tu app envía un Android Intent a un URI específico (por ejemplo,
getnet://payment/v1/payment) con los datos de la transacción. -
Procesamiento: la app de Getnet procesa el comando y gestiona la comunicación con los servidores del adquirente para completar la transacción de forma segura.
-
Respuesta: la app de Getnet devuelve a tu aplicación una respuesta estructurada con el estado de la transacción y los datos del comprobante.
Automatización de pantallas
Una de las principales ventajas del modelo App2App es la posibilidad de simplificar la interfaz de usuario en el TPV. Según los parámetros que tu aplicación envíe en la solicitud, la app de Getnet puede omitir automáticamente determinadas pantallas de ingreso.
Por ejemplo, si incluyes el importe de la transacción o el método de pago en tu deeplink, el terminal omite esos pasos de ingreso manual y continúa directamente con la siguiente fase del flujo. En cambio, si faltan parámetros obligatorios, la app muestra las pantallas de ingreso manual para completar los datos.
Siguientes pasos
Para comenzar la integración, sigue este recorrido:
-
Lee Arquitectura y flujo para comprender en profundidad la comunicación local mediante Android Intents y cómo gestionar el ciclo de vida de la app.
-
Realiza una Verificación de conectividad (Polling) para ejecutar el “handshake” inicial y confirmar que el servicio de pago está listo antes de iniciar una venta.
-
Sigue la Guía de inicio rápido para procesar tu primera transacción de prueba (SALE) en minutos con los ejemplos de código que ofrecemos.