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.

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/;
Seguir o Human Interface Guideline que todo aplicativo que implementar o SDK deverá seguir. Tap to Pay on iPhone | Apple Developer Documentation ;
Exibir as telas de educação do framework Apple obrigatoriamente após a primeira inicialização do SDK e mantê-las acessíveis a qualquer momento em ajuda/configurações. As imagens devem ser exatamente as fornecidas pela Apple, sem alteração. A Cielo provê, dentro do SDK, o método showEducationScreen para apresentação dessas telas;
Somente o administrador do estabelecimento, com Apple ID, pode aceitar os termos Apple;
O app deve ter preenchido na sua info.plist o parâmetro “NSUserTrackingUsageDescription” com uma mensagem reference à coleta de dados para log ;
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

Requisitos	iOS
Versão mínima do Sistema Operacional	iOS 18.5
Acesso à internet	Sim
Mínimo de espaço livre no dispositivo	50mb
NFC no Dispositivo	Sim
Dispositivo	iPhone XS ou mais recente

Requisitos do Sistema para Desenvolvimento

Requisitos	iOS
IDE	XCode 15+ recomendado
Swift	Swift 5+
Conta de sandbox	Para 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.

Toolkit de IA.