• O kernelInitialize() é o primeiro método obrigatório que deve ser chamado antes de usar qualquer funcionalidade do SDK.

• Onde chamar: chame na classe Application do app, dentro do método onCreate().

class MyApplication : Application() {
                                                                                                                override fun onCreate() {
                                                                                                                    super.onCreate()
                                                                                                                    if (!TapOnPhone.kernelInitialize(this))
                                                                                                                        return
                                                                                                                }
                                                                                                            }

• Essa condição evita a execução duplicada do código, garantindo que o kernel seja inicializado apenas uma vez.

• Para mais informações, consulte a seção Inicialização do Kernel.

• O setConfig() é um método obrigatório usado para configurar as credenciais e as configurações do SDK em uma única chamada.

• Quando chamar: deve ser chamado após kernelInitialize() e antes de usar qualquer outro método do SDK.

• O método recebe um objeto ConfigParameters contendo contexto, credenciais e configurações opcionais.

• Para mais informações, consulte a seção Definir configurações do SDK.

• Não. A inicialização é opcional e pode ser feita de duas formas:

  1. Manualmente: chamando TapOnPhone.initialize() antes do pagamento.

  2. Automaticamente: se não for feita manualmente, o SDK realizará a inicialização automaticamente quando você chamar TapOnPhone.pay().

• A inicialização manual é recomendada para evitar tempo de espera no primeiro pagamento.

• Para mais informações sobre o método de inicialização, consulte a seção Inicialização.

• Sim. É possível e recomendado criar a sessão antes do pagamento usando o método TapOnPhone.activateSession().

• Isso reduz o tempo de espera e melhora a experiência do usuário.

• Para mais informações sobre ativação de sessão, consulte a seção Ativação da Sessão.

• Para otimizar o tempo de pagamento e melhorar a experiência do usuário, recomenda-se:

  1. Inicializar o SDK durante o carregamento do app: chamar TapOnPhone.initialize() logo após o setConfig().

  2. Ativar a sessão após a inicialização: chamar TapOnPhone.activateSession() logo após a inicialização bem-sucedida.

  3. Pagar: chamar TapOnPhone.pay() para iniciar o processo de pagamento.

• Com essas práticas, o pagamento será mais rápido, pois tanto a inicialização quanto a criação da sessão já terão sido concluídas previamente.

• Para mais detalhes, consulte as seções Inicialização e Ativação da Sessão.

• O SDK é inicializado apenas uma vez, não necessariamente antes de toda venda.

• Não existe um tempo limite. A sessão deve ser inicializada sempre que o app é encerrado ou antes de qualquer pagamento.

• Credenciais incorretas no processo de onboarding. Verifique novamente as credenciais abaixo:

  • clientId
  • clientSecret

• Erro nas informações do seu aplicativo. Verifique se os dados abaixo estão corretos:

  • packageName
  • versionCode
  • SHA-256 Fingerprint

• Verifique se o manifesto do seu aplicativo (AndroidManifest.xml) não está com a configuração abaixo, pois isso pode impossibilitar a inicialização do SDK:

<provider
                                                                                                            android:name="androidx.startup.InitializationProvider"
                                                                                                            android:authorities="${applicationId}.androidx-startup"
                                                                                                            tools:node="remove">
                                                                                                            </provider>

• Para mais informações sobre credenciais, consulte as seções Onboarding e Inicialização.

• Sim. Nesses casos, adicione as seguintes configurações no arquivo proguard-rules.pro:

-keep class com.zoop.sdk.** { *; }
                                                                                                            -keep class com.mypinpad.tsdk.** { *; }
                                                                                                            -keep class javax.naming.** { *; }
                                                                                                            -keep class javax.naming.directory.** { *; }
                                                                                                            -dontwarn javax.naming.**
                                                                                                            -dontwarn javax.naming.directory.**
                  

• Erros de attestation estão associados à não aprovação do aparelho pela Play Store e a outras métricas de segurança.

• Credenciais incorretas também podem ocasionar esse erro.

• O versionCode do aplicativo na Play Store pode não estar liberado na Zoop. Verifique o range de versões liberado para uso.

• Celular em modo Debug ou com root impedirá o uso do aplicativo com o SDK.

• Ver também: Attestation e instanceId (quando o attestationStatus aparece nas respostas de erro).

• Não. O app com o SDK nesses dois modos não passará nas etapas de segurança e provavelmente retornará um dos erros de Attestation.

• O SLA é de até 7 dias após o pedido de liberação.

• Não. As credenciais são únicas para cada aplicativo liberado na loja.

• As transações do SDK aceitam metadata e referenceId, que podem conter informações para esse controle.

• A implementação e o gerenciamento dessa identificação ficam a cargo do desenvolvimento do parceiro.

• Sim. A partir do SDK 2.3.1, use a dependência com.zoop.sdk:taponphone-sandbox-debug no Gradle no lugar de staging/production.

• Consulte também a seção Ambiente Sandbox.

• Para fluxos que dependem de produção e das políticas das lojas, siga as orientações do onboarding e do suporte.

• Sim. O modo Sandbox está disponível no SDK a partir da versão 2.3.1 para integração e testes sem publicar o aplicativo na loja.

• Consulte a seção Ambiente Sandbox.

• Não. A Zoop não oferece suporte para essas tecnologias.

• Garantir o funcionamento da integração em React Native ou Flutter é responsabilidade da equipe de desenvolvimento.

• Não.

• É necessário apenas enviar um vídeo do fluxo de pagamento completo do aplicativo desenvolvido até a tela de sucesso, com a animação da bandeira Visa e Elo.

• O suporte técnico na integração do app cobre apenas problemas associados diretamente ao SDK.

• A Zoop não oferece suporte ao desenvolvimento do aplicativo.

• É responsabilidade do parceiro garantir uma equipe técnica qualificada para realizar a integração.

• Não.

• Não. Isso deve ser apresentado na animação de aproximação pelo próprio parceiro que realiza o desenvolvimento.

• O SDK oferece a funcionalidade de verificar a antena NFC do dispositivo por meio da classe CardProximityReader. Para mais detalhes, consulte a seção Leitor de Proximidade.

• Sim. No menu Configurações do Tema, é possível visualizar essa opção.

• Não. Não há um limite determinado.

• Como referência, essa animação está com largura de 343px e altura de 250px.

• As páginas de memória de 16KB são uma nova exigência do Google Play para aplicativos que visam o Android 15 ou versões mais recentes.

• Essa mudança é necessária para garantir compatibilidade futura, otimização de memória e conformidade com as políticas do Google Play.

• Prazo: 31 de outubro de 2025, com possibilidade de extensão até 30 de maio de 2026.

• Consequência: se as atualizações do seu app não forem compatíveis com páginas de 16KB, não será possível lançá-las após o prazo.

• A partir da versão 1.7.2, o SDK Zoop já inclui suporte para páginas de 16KB.