Requisitos

Este guia irá orientá-lo através dos requisitos do SDK, como configurar e inicializar a biblioteca, as diferentes jornadas disponíveis, como usar o white label e como realizar transações.

Requisitos Apple

Para que o SDK funcione propriamente no iOS a Apple necessita de algumas pré configurações e que suas guidelines sejam respeitadas.

  1. Solicitar no portal de desenvolvedor da Apple o capability de “TapToPay on iPhone”, indicando que o aplicativo contará com tal funcionalidade. https://developer.apple.com/contact/request/contactless-payments/;
  2. Seguir o Human Interface Guideline que todo aplicativo que implementar o SDK deverá seguir. Tap to Pay on iPhone | Apple Developer Documentation ;
  3. Exibir de forma fácil para o usuário as chamadas telas de educação que contam com um tutorial de como utilizar o framework da Apple para pagamentos, contendo uma explicação da possibilidade de pagamento por um cartão comum ou Apple Pay (Também abrangente a outras carteiras digitais) e que o PIN do cartão poderá ser solicitado caso necessário. Tais telas deverão obrigatoriamente ser apresentadas após a primeira inicialização do SDK além de serem acessíveis a qualquer momento em uma área de ajuda ou configurações após a primeira inicialização. Todas as imagens utilizadas deverão ser as fornecidas pela Apple e não poderão sofrer alterações. A Cielo irá prover dentro do SDK uma função para apresentação dessas telas;
  4. O aplicativo deverá contar com um controle de usuário para que somente um administrador do estabelecimento comercial possa dar o aceite nos termos e condições da Apple. Para aceitar os termos será necessário um Apple ID;
  5. O app deve ter preenchido na sua info.plist o parâmetro “NSUserTrackingUsageDescription” com uma mensagem reference à coleta de dados para log ;
  6. Qualquer invocação ao SDK deverá seguir o padrão estipulado pela Apple. Um botão com o texto “Tap to Pay no iPhone” ou “Tap to Pay” se não houver espaço. Caso seja escolhido utilizar um ícone junto do botão ele obrigatoriamente deverá ser wave.3.right.circle ou wave.3.right.circle.fill.

Requisitos Técnicos do SDK

RequisitosiOS
Versão mínima do Sistema OperacionaliOS 18.5
Acesso à internetSim
Mínimo de espaço livre no dispositivo50mb
NFC no DispositivoSim
DispositivoiPhone XS ou mais recente

Requisitos do Sistema para Desenvolvimento

RequisitosiOS
IDEXCode 15+ recomendado
SwiftSwift 5+
Conta de sandboxPara testes em HML é necessário ter uma conta de sandbox. Para maiores informações sobre como criar, acesse esse link

Toolkit de IA: Implantação a partir de agentes especialistas

Com o objetivo de simplificar a implementação e o suporte às integrações, disponibilizamos um toolkit agêntico capaz de interpretar a documentação técnica, realizar validações estruturais, apoiar processos de homologação, executar implementação dos métodos públicos no seu projeto e fornecer suporte operacional de forma padronizada, rastreável e auditável.

📘

O toolkit está em fase de testes e pode apresentar imprecisões ou interpretações incorretas. As informações fornecidas por agentes de IA devem ser utilizadas apenas como apoio. Para validação final de requisitos, regras e especificações técnicas, consulte sempre a documentação completa.


Did this page help you?