Visión general del SDK White Label

Bienvenido a la documentación del SDK White Label. El SDK White Label es la solución white-label de Getnet para terminales POS Android. Permite que tu aplicación ejecute flujos completos de pago presencial directamente en el terminal, sin que tengas que lidiar con el hardware ni con los servicios de pago. En el código, su punto de entrada es la clase ApoloSdk.

Qué es el SDK White Label

El SDK White Label es una biblioteca Android que incorporas en tu propia aplicación. Una vez integrado, tu aplicación puede iniciar ventas, reembolsos e impresión de recibos desde un único punto de entrada: ApoloSdk.Builder.

El SDK se encarga de tres frentes que, de otro modo, te exigirían un esfuerzo considerable:

  • Operación del terminal — el SDK controla el hardware del terminal necesario para la transacción.
  • Comunicación con los servicios de pago — la autenticación, la autorización, la captura y las verificaciones de disponibilidad ocurren dentro del SDK.
  • Flujos listos para usar — las pantallas, las transiciones, los estados de error y los mensajes al titular de la tarjeta vienen como un paquete, con puntos de extensión definidos.
El SDK no mantiene un historial de transacciones y no reemplaza a tu backend en la conciliación, la emisión fiscal ni los informes. Esas responsabilidades siguen siendo de tu aplicación.

Como depende de hardware y servicios que existen solo en dispositivos POS, el SDK no funciona en emuladores, máquinas virtuales ni celulares Android comunes.

Cómo funciona

El SDK sigue un modelo Single-Activity: todas las pantallas del flujo de transacción viven dentro de una Activity dedicada, alojada por el SDK. Tu aplicación dispara una operación, el SDK toma el control de la interfaz y ese control vuelve a tu aplicación cuando la operación termina.

Una integración típica pasa por cuatro momentos:

  1. Inicialización — configuras el SDK una sola vez, durante el arranque de tu aplicación.
  2. Warm-up — el SDK carga la configuración del terminal y se autentica en los servicios de pago, e informa el progreso a tu aplicación.
  3. Operación — cuando el warm-up termina con éxito, tu aplicación inicia una venta, un reembolso o una impresión.
  4. Resultado — cuando el flujo termina, el SDK devuelve un resultado tipado a través de un callback.

Entre el ingreso del monto y el resultado final, el SDK ejecuta toda la transacción internamente.

Una experiencia white-label

Cada operación incluye las pantallas propias del SDK, que guían al titular de la tarjeta durante el recorrido en el terminal. Puedes conservar las pantallas listas para usar o adaptarlas a tu marca:

  • Aplica los colores de tu marca mediante la personalización del tema.
  • Inserta pantallas entre los pasos existentes del flujo.
  • Reemplaza la apariencia de una pantalla y conserva su comportamiento.
  • Personaliza los recibos que se imprimen para el establecimiento y para el cliente.

Así, la experiencia puede ir desde las pantallas predeterminadas del SDK hasta un flujo hecho totalmente a la medida de tu aplicación.

Dónde se ubica el SDK

El SDK White Label se ejecuta en el terminal, del lado del cliente. Depende del servicio de gestión de terminales de Getnet para dos cosas: la configuración que carga durante el warm-up y las credenciales con las que se autentica. Los pagos se procesan luego de forma presencial a través de SEP.

El SDK White Label funciona solo en terminales POS Android. Está diseñado para socios que ya tienen una relación con Getnet y quieren aceptar pagos desde su propia aplicación.

Siguientes pasos

Para comenzar tu integración, sigue este recorrido:

  • Requisitos previos — confirma el entorno, las credenciales y los servicios del terminal que necesitas antes de integrar.
  • Agrega el SDK a tu proyecto — configura la dependencia, los permisos y los servicios requeridos en el terminal.
  • Inicio rápido — inicializa el SDK y ejecuta tu primera venta.
  • Procesa una venta — ejecuta cada medio de pago y modalidad, y luego explora los reembolsos, la impresión y la personalización.

En esta página

Visión general del SDK White Label