Versões
Histórico de versões e release notes do SDK Tap on Phone - iOS.
3.4.11
19 de Maio de 2026
Instalação
Download do XCFramework para adição manual do SDK.
Release Notes
Correções
- Ajuste no fluxo quando há atualização do kernel (
kernelUpdate), para que os eventos sejam emitidos durante a ativação da sessão - Ajuste para exibir uma tela de processamento, caso o método de pagamento seja chamado enquanto a sessão ainda está sendo ativada
3.4.10
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 e corrige um bug ao chamar o método pay durante activateSession em que a tela de processamento não era exibida.
Principais alterações
O setConfig passa a aceitar environment: .sandbox, permitindo testar o fluxo sem cobrança real.
O seller pode ser omitido no setConfig. Troque de seller em runtime via initialize(sellerId:).
Códigos 6108 e 6109 para validação de seller nos modos multiseller e single-seller.
Enum SdkScreenTransitionStyle exposto para configurar a animação de apresentação da tela do SDK.
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âmetrosellerdas credenciais pode ser omitido ounil/vazio — é o modo multiseller. - O seller efetivo entra em
TapOnPhone.initialize(sellerId:), permitindo trocar de seller em runtime com novas chamadas ainitialize, sem novosetConfig. - Se o
setConfigfor passado comsellerpreenchido, vale o modo single-seller (seller fixo na configuração).
Saiba mais em Multiseller.
Novos códigos de erro
| Código | Descrição |
|---|---|
6108 | sellerNotProvidedOnInit — falta sellerId no initialize em modo multiseller (setConfig com seller nil/vazio). |
6109 | sellerNotAllowedOnInitialize — em modo single-seller (setConfig com seller preenchido), o initialize recebe um sellerId diferente do valor configurado. |
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.
Updated 5 days ago