Getnet DocsGetnet Docs

Visión general de fabricantes POS

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page
Connect to CursorUse these docs in CursorConnect to VS CodeUse these docs in VS Code

Esta área documenta cómo un fabricante de hardware homologa un nuevo dispositivo POS con la plataforma POS Digital de Getnet. Está dirigida al equipo de ingeniería del fabricante, no a un integrador de software orientado al comercio. Si integras un terminal Getnet en el software de un comercio, consulta App2App, Host-to-Host o POS Integrado.

Qué es la integración de fabricantes POS

Para procesar pagos de Getnet, un dispositivo POS necesita una Manufacturer Service App. Este servicio Android expone el hardware del dispositivo — lectores de tarjetas, impresora, beeper, LED, cámara — a través de un conjunto fijo de interfaces que tu equipo construye. Getnet proporciona esas interfaces en una biblioteca llamada libhalservice.aar. Una vez que tu servicio las implementa, el propio software de Getnet puede manejar tu hardware sin código específico del dispositivo.

Getnet llama Middleware App a la capa que habla con tu servicio. Se sitúa entre tu Manufacturer Service App y el SDK que los socios de Getnet integran en sus propias aplicaciones. Ese SDK, SDK PagoNxt, se expone a través de libposemv y libposdigital. Desde tu lado nunca hablas directamente con las aplicaciones de los socios. Solo implementas el contrato HAL (Hardware Abstraction Layer): la Middleware App hace el resto.

Getnet también te da dos herramientas para validar tu implementación antes de enviarla:

  • El Devkit — una aplicación de prueba que ejercita las llamadas de hardware de tu servicio (beeper, impresora, lectores de tarjetas, etc.).
  • La Manufacturer Test App — una aplicación construida por Getnet, centrada en el procesamiento EMV. Cubre la inicialización del servicio, la carga de AID y CAPK, y los escenarios obligatorios por marca de tarjeta.

Cómo funciona

Construyes la Manufacturer Service App como un servicio Android, con el nombre de paquete com.pagonxt.hal.platform.service, e implementas las interfaces de libhalservice.aar. La Middleware App se vincula a tu servicio mediante ese nombre de paquete y llama a sus métodos de la misma forma para todos los fabricantes. Tu implementación es lo que hace que el hardware de un dispositivo concreto responda correctamente.

Cuando tu servicio responde correctamente al Devkit, ejecutas los escenarios obligatorios en la Manufacturer Test App. Superar esos escenarios genera un informe de pruebas. Envías ese informe, junto con algunos otros artefactos, para continuar el proceso de homologación con Getnet.

Dónde encaja

La integración de fabricantes POS está por debajo de todos los demás modos de integración de esta documentación. App2App, Host-to-Host y POS Integrado dan por supuesto un terminal que ya ejecuta el software de Getnet. Esta área es lo que lo hace posible para un hardware nuevo. Getnet revisa tu envío antes de que tu dispositivo quede disponible por esos canales.

Próximos pasos