Versões

3.5.0

---

27 de Julho de 2026

Instalação

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

Release Notes

Esta versão introduz o método isAccountLinked para verificação do vínculo da conta Apple ID com o terminal e a simulação de atualização de kernel da Apple no ambiente sandbox com iOS Simulator.

Principais alterações

• isAccountLinked: Novo método para verificar de forma silenciosa se a conta Apple ID do usuário já está vinculada ao terminal Tap to Pay on iPhone.

  • Não apresenta UI, não vincula nem desvincula a conta
  • Apenas retorna true (vinculada) ou false (não vinculada) no callback onSuccess
  • Pode ser chamado após setConfig(), sem necessidade de initialize()
  • Útil para decidir se é necessário chamar processTermsAndConditions() para vincular a conta
  • Se houver outra operação em andamento, retorna erro operationInProgress (código 6100)

• Simulação de Apple Kernel Update (Sandbox + Simulador)

  • Em ambiente sandbox rodando no iOS Simulator, o SDK agora simula o fluxo de atualização de kernel da Apple, permitindo testar o comportamento do app durante esse processo sem hardware físico.
  • Ao realizar um pagamento com valor de exatamente R$ 6,01 (601 centavos) no simulador em sandbox, o SDK dispara uma sequência de eventos simulando o progresso da atualização de kernel
  • O evento kernelUpdateProgress(Int) é emitido progressivamente de 0 a 100 em aproximadamente 8 segundos via callback onEvent
  • Após a simulação, o fluxo de pagamento continua

3.4.12

---

10 de Junho de 2026

Instalação

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

Release Notes

Esta versão introduz o suporte a pagamentos simulados no iOS Simulator.

O SDK agora permite executar o fluxo de pagamento completo no iOS Simulator, facilitando testes automatizados e de integração sem necessidade de dispositivo físico ou cartão NFC.

As transações são realizadas com dados de cartões de teste e são enviadas exclusivamente para o ambiente de sandbox da Zoop.

Para utilizar o simulador, basta executar o app em um iOS Simulator configurado para utilizar o ambiente de sandbox. Não é necessário realizar nenhuma alteração na integração com o SDK.

Também é possível simular pagamentos negados no ambiente de sandbox. Para isto, basta realizar um pagamento com valor entre R$5,01 e R$5,99 e a transação será negada com o código de erro6015 e o paymentError.acquirerCode equivalente à quantidade de centavos passados no valor, por exemplo: R$5,05 retorna o código 4005.

Restrições:

• Ambientes production e custom são bloqueados no simulador.
• Valor máximo por transação simulada: R$ 200,00.

Correções

• Corrigido crash (SWIFT TASK CONTINUATION MISUSE) que ocorria durante a exibição da animação de branding (Visa, Elo).

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

---

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.

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.