Versões
Histórico de versões e release notes do SDK Tap on Phone - Android.
2.3.1 - Android
15 de Abril de 2026
Instalação
Adicione a dependência no build.gradle:
releaseImplementation("com.zoop.sdk:taponphone-production-release:2.3.1")Release Notes
Essa versão introduz Multiseller, suporte a sandbox, orientação landscape e melhorias em diagnóstico de erros.
Principais alterações
Vários sellers compartilham a mesma configuração do SDK. Troque de seller em runtime sem reiniciar.
Valide o funcionamento em ambiente de testes fora da loja com a dependência dedicada.
Suporte à orientação paisagem nas telas do SDK.
Campo kernelRedactLog no payload de erro para auxiliar suporte.
Multiseller
Modo em que vários sellers podem usar a mesma configuração do SDK:
- O
sellerdeixa de ser obrigatório nosetConfige passa a ser informado noinitialize. - Permite trocar de seller em runtime com uma nova chamada a
initialize, sem reiniciar o SDK e sem novosetConfig.
Saiba mais em Multiseller.
Novos códigos de erro
| Código | Descrição |
|---|---|
2040 | Timeout na criação do terminal no kernel — Creating terminal timed out. Terminal creation exceeded the allowed time limit. |
1023 | Seller não informado na inicialização em modo multiseller — seller not provided on initialization. |
1024 | Tentativa de alterar o seller no initialize quando ele já está definido no setConfig — seller cannot be changed in initialize when already set in setConfig. |
Consulte Criação de terminal e Multiseller.
kernelRedactLog
Adicionado ao payload de onError o campo kernelRedactLog, contendo mensagens de log da operação (padrão e redatadas) para auxiliar diagnóstico e suporte.
Trate o conteúdo de
kernelRedactLogcomo dado sensível. Não exponha em logs públicos ou interfaces de usuário.
Orientação Landscape
Adicionado suporte à orientação paisagem nas telas do SDK através da configuração SdkConfig.allowLandscape.
Detalhes em Orientação landscape.
Sandbox
Adicionado suporte ao modo sandbox com a dependência dedicada no Gradle, permitindo validar o funcionamento em ambiente de testes fora da loja:
debugImplementation("com.zoop.sdk:taponphone-sandbox-debug:2.3.1")Consulte Ambiente de Sandbox e Adicionar ao Projeto.
2.1.3 - Android
14 de janeiro de 2026
Instalação
Adicione a dependência no build.gradle:
releaseImplementation("com.zoop.sdk:taponphone-production-release:2.1.3")Release Notes
Essa versão introduz uma arquitetura reformulada com a classe TapOnPhone como singleton e com 3 etapas simples (kernelInitialize → setConfig → pay), além de Device Attestation com tratamento detalhado de erros de integridade e códigos de erro específicos.
O uso como singleton garante uma única instância do SDK em toda a aplicação, evitando conflitos de estado, múltiplas inicializações do terminal e problemas de concorrência, além de simplificar o gerenciamento de recursos e melhorar a performance.
Principais melhorias:
- Criação da sessão de forma separada do pagamento
- Sistema unificado de tratamento de erros com
ErrorResponse - Callbacks de eventos obrigatórios em todos os métodos
- Melhorias em logging e métricas
- Tratamento aprimorado de erros NFC
- Correção de bugs
Updated 5 days ago