Visão geral de fabricantes POS

Esta área documenta como um fabricante de hardware homologa um novo dispositivo POS na plataforma POS Digital da Getnet. Destina-se à equipe de engenharia do fabricante, não a um integrador de software voltado ao estabelecimento. Se você integra um terminal Getnet ao software de um estabelecimento, consulte App2App, Host-to-Host ou POS Integrado.

O que é a integração de fabricantes POS

Para processar pagamentos da Getnet, um dispositivo POS precisa de uma Manufacturer Service App. Esse serviço Android expõe o hardware do dispositivo — leitores de cartão, impressora, beeper, LEDs, câmera — por meio de um conjunto fixo de interfaces que sua equipe constrói. A Getnet fornece essas interfaces em uma biblioteca chamada libhalservice.aar. Depois que seu serviço as implementa, o próprio software da Getnet consegue operar seu hardware sem código específico do dispositivo.

A Getnet chama de Middleware App a camada que conversa com seu serviço. Ela fica entre sua Manufacturer Service App e o SDK que os parceiros da Getnet embarcam nas próprias aplicações. Esse SDK, o SDK PagoNxt, é exposto por libposemv e libposdigital. Do seu lado, você nunca fala diretamente com as aplicações dos parceiros. Você só implementa o contrato HAL (Hardware Abstraction Layer) — a Middleware App faz o resto.

A Getnet também oferece duas ferramentas para validar sua implementação antes do envio:

• O Devkit — uma aplicação de teste que exercita as chamadas de hardware do seu serviço (beeper, impressora, leitores de cartão e assim por diante).
• A Manufacturer Test App — uma aplicação construída pela Getnet, focada no processamento EMV. Cobre a inicialização do serviço, o carregamento de AIDs e CAPKs e os cenários obrigatórios por bandeira de cartão.

Como funciona

Você constrói a Manufacturer Service App como um serviço Android, com o nome de pacote com.pagonxt.hal.platform.service, e implementa as interfaces de libhalservice.aar. A Middleware App se vincula ao seu serviço por esse nome de pacote e chama seus métodos da mesma forma para todos os fabricantes. Sua implementação é o que faz o hardware de um dispositivo específico responder corretamente.

Quando seu serviço responde corretamente ao Devkit, você executa os cenários obrigatórios na Manufacturer Test App. Passar nesses cenários gera um relatório de testes. Você envia esse relatório, junto de alguns outros artefatos, para seguir com o processo de homologação na Getnet.

Onde se encaixa

A integração de fabricantes POS está abaixo de todos os outros modos de integração desta documentação. App2App, Host-to-Host e POS Integrado pressupõem um terminal que já roda o software da Getnet. Esta área é o que torna isso possível para um hardware novo. A Getnet revisa seu envio antes que seu dispositivo fique disponível por esses canais.

Próximos passos

• Configuração da integração HAL — empacote seu serviço e exponha as interfaces exigidas.
• Início rápido: executar o Devkit — valide sua implementação com as ferramentas de teste da Getnet.
• Arquitetura HAL — como a Middleware App, a libhalservice e seu serviço se relacionam.
• Referência de interfaces de serviço — todas as interfaces que seu serviço pode implementar.