SmartPOS SDK
Documentação inicial do Plugin SmartPOS da Zoop para onboarding, configuração, ativação, pagamentos, cancelamentos, impressão e operação em terminais Gertec e Pax.
Integre pagamentos, cancelamentos, impressão de recibos e operações de terminal SmartPOS usando o Plugin SmartPOS da Zoop.
Esta documentação está organizada por jornada. Se você está começando agora, leia a visão geral antes de seguir para onboarding, requisitos e configuração do projeto Android.
Entenda o Plugin SmartPOS, terminais suportados, jornada recomendada e pontos críticos da integração.
Solicite acesso, compre máquinas de debug e prepare a distribuição com Gertec ou Pax.
Adicione o Maven da Zoop, dependências Kotlin, permissões Android e configurações do Gradle.
Comece aqui
Siga esta ordem para reduzir problemas de configuração, ativação e deploy em produção.
| Etapa | Página | Objetivo |
|---|---|---|
| 1 | Onboarding do fabricante | Solicite credenciais, máquina de desenvolvimento e acesso à documentação do fabricante. |
| 2 | Requisitos do terminal | Confira a versão de firmware exigida para Gertec GPOS720 ou Pax A910/A910S. |
| 3 | Arquivos de exemplo | Use o app de exemplo, APKs por fabricante e pacotes Gradle como referência. |
| 4 | Ambiente Android | Use Android Studio e Kotlin 1.9.0, conforme o projeto de exemplo. |
| 5 | Dependências do plugin | Adicione o repositório Maven, a dependência do modelo SmartPOS e as bibliotecas auxiliares. |
| 6 | Permissões Android | Solicite em tempo de execução as permissões que exigem aprovação do usuário, como READ_PHONE_STATE e ACCESS_FINE_LOCATION. |
| 7 | Deploy no terminal | Compile, instale em debug ou siga o processo de produção do fabricante. |
| 8 | Ativação do terminal | Gere o token de ativação, pareie no dashboard e salve as credenciais retornadas. |
| 9 | Inicialização do SDK | Inicialize o SDK com as credenciais salvas e conecte o SmartPOSPlugin. |
| 10 | Chave transacional | Consulte a chave na inicialização do plugin para evitar falhas em pagamentos com cartão. |
A ausência da chave transacional impede transações com cartão. Se o terminal não possuir a chave, ele deve ser enviado ao fabricante para correção.
Fluxo principal de integração
Baixe o plugin, o código do app de exemplo e APKs por fabricante.
Prepare Android Studio, Kotlin e projeto base para desenvolvimento.
Compile, instale em debug e entenda as exigências para produção.
Gere o token de ativação, confirme no dashboard e armazene as credenciais.
Inicialize o SDK, configure logs, strict mode e conecte o plugin.
Consulte se o terminal possui a chave necessária para transacionar.
Funcionalidades
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.
Gere relatórios consolidado, detalhado e de fechamento de turno.
Recupere os dados da última transação para visualização ou impressão.
Operações complementares
Force a atualização de tabelas sem iniciar um fluxo de venda.
Detecte inserção ou remoção de cartão em segundo plano.
Recupere o identificador criptografado do cartão.
Acesse métodos públicos do dispositivo, como APN, número de série e modo debug.
Remova o aplicativo Zoop da Gertec GPOS720 via pendrive USB-C ou MDM.
Consulte versões, pacotes Gradle e notas de release do Plugin SmartPOS.
Pontos que exigem atenção
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.
Updated 6 days ago