2.3.0/3.4.10

2.3.0 - Android

08 de Abril de 2026

Instalação

Adicione a dependência no build.gradle:

releaseImplementation("com.zoop.sdk:taponphone-production-release:2.3.0")

Release Notes

Essa versão introduz Multiseller, suporte a sandbox, orientação landscape e melhorias em diagnóstico de erros.

Principais alterações

Multiseller

Modo em que vários sellers podem usar a mesma configuração do SDK:

• O seller deixa de ser obrigatório no setConfig e passa a ser informado no initialize.
• Permite trocar de seller em runtime com uma nova chamada a initialize, sem reiniciar o SDK e sem novo setConfig.

Saiba mais em Multiseller.

Novos códigos de erro

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 kernelRedactLog como 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.0")

Consulte Ambiente de Sandbox e Adicionar ao Projeto.

3.4.10 - iOS

14 de Abril de 2026

Instalação

Download do XCFramework para adição manual do SDK.

Release Notes

Essa versão introduz ambiente sandbox, modo multiseller, novos códigos de erro e configuração de transição de tela.

Principais alterações

Ambiente Sandbox

O setConfig passa a aceitar environment: .sandbox, apontando para a API de pagamentos em sandbox da Zoop — opção para testar o fluxo sem cobrança real.

⚠️

É necessário usar a conta sandbox da Apple no aparelho. Veja Conta Sandbox.

Multiseller

Modo em que vários sellers podem usar a mesma configuração do SDK:

• No setConfig, o parâmetro seller das credenciais pode ser omitido ou nil/vazio — é o modo multiseller.
• O seller efetivo entra em TapOnPhone.initialize(sellerId:), permitindo trocar de seller em runtime com novas chamadas a initialize, sem novo setConfig.
• Se o setConfig for passado com seller preenchido, vale o modo single-seller (seller fixo na configuração).

Saiba mais em Multiseller.

Novos códigos de erro

Consulte Erros do SDK e Multiseller.

Transição da tela do SDK

Exposto o enum SdkScreenTransitionStyle e o parâmetro screenTransitionStyle em TapOnPhoneTheme, permitindo configurar como a tela built-in do SDK (loading/processamento) é apresentada:

• Transições nativas do iOS
• Slides por direção
• Sem animação

O padrão permanece coverVertical, alinhado ao comportamento anterior.

Detalhes em Customização.