Visão geral do Plugin SmartPOS
Material de apoio Descrição: Entenda o Plugin SmartPOS da Zoop, terminais suportados, jornada recomendada, funcionalidades e pontos críticos de integração para Gertec e Pax.
Entenda o que o Plugin SmartPOS faz, quais terminais são suportados e qual jornada seguir para integrar pagamentos, cancelamentos, impressão e operações do terminal.
Use esta página como visão geral antes de seguir para configuração, ativação e funcionalidades transacionais.
O que é o Plugin SmartPOS
O Plugin SmartPOS é responsável por consumir serviços de pagamento e cancelamento em terminais SmartPOS, além de oferecer funcionalidades complementares para operação do dispositivo.
Com o plugin, sua aplicação Android pode executar fluxos como:
- pagamento via cartão;
- pagamento via Pix por QR Code ou Pix NFC;
- cancelamento de transações;
- impressão de recibos e relatórios;
- ativação do terminal;
- consulta de chave transacional;
- atualização de carga de tabelas;
- detecção de cartão;
- recuperação de token único por cartão;
- geração de relatórios;
- consulta do último recibo;
- acesso a métodos públicos do fabricante.
Terminais suportados
| Fabricante | Terminal |
|---|---|
| Gertec | GPOS720 |
| Pax | A910/A910S |
Antes de testar fluxos transacionais, valide o firmware e os requisitos do modelo usado. Firmware incompatível pode causar falhas de inicialização, leitura de cartão, impressão ou execução de fluxos do plugin.
Jornada recomendada
Siga esta ordem para reduzir falhas de ambiente, ativação e operação em produção.
1. Faça o onboarding. Solicite acessos, máquinas de desenvolvimento e documentação do fabricante.
2. Valide os requisitos do terminal. Confira modelo, firmware e ficha técnica.
3. Baixe os arquivos necessários. Use o app de exemplo, APKs por fabricante e pacotes Gradle.
4. Configure o ambiente Android. Prepare Android Studio e Kotlin 1.9.0.
5. Configure o projeto. Adicione Maven, dependências, permissões e ajustes de Gradle.
6. Faça deploy no terminal. Instale em dispositivo de debug ou siga o processo de produção do fabricante.
7. Ative o dispositivo. Gere o token, pareie no dashboard e salve as credenciais.
8. Inicialize o SDK. Use as credenciais salvas e plugue o SmartPOSPlugin.
9. Valide a chave transacional. Confirme que o terminal está apto a transacionar com cartão.
10. Implemente as funcionalidades. Adicione pagamento, Pix, cancelamento, impressão e demais fluxos.
Páginas principais
Fluxos transacionais
Crie pagamentos com crédito, crédito parcelado ou débito.
Crie cobranças Pix por QR Code ou Pix NFC.
Cancele transações específicas ou selecione transações listadas no terminal.
Imprima vias do cliente, estabelecimento, reimpressões e relatórios.
Operações complementares
Confirme se o terminal possui a chave necessária para pagamentos com cartão.
Force atualização de tabelas sem iniciar uma venda.
Detecte inserção ou remoção de cartão em segundo plano.
Gere relatórios consolidado, detalhado e de fechamento de turno.
Pontos críticos
Versão mais recente
A versão mais recente documentada é a 1.12.16.
implementation("br.zoop.pos.plugin:smartpos-gertec-gpos720:1.12.16") // Para a Gertec GPOS720
implementation("br.zoop.pos.plugin:smartpos-pax-a910:1.12.16") // Para a Pax A910A versão 1.12.16 corrige uma falha no processo de carga de tabelas automática e atualiza a biblioteca NeptuneLite para a versão 4.18 nos modelos Pax A910 e A910S.
Próximo passo
Comece pelo Onboarding SmartPOS para preparar acessos, máquinas de desenvolvimento e distribuição com o fabricante.
Updated 9 days ago