iOS

Abra o fluxo de verificação num app iOS e receba os eventos da sessão em Swift.

Ao final deste guia o fluxo abre dentro do seu app iOS, com a câmera liberada e os eventos chegando ao seu código Swift.

O SDK iOS está em preview (v1.0.0-alpha.1). A superfície pode mudar entre versões de preview. Fale com o suporte antes de usá-lo em produção.

Pré-requisitos

• iOS 13 ou superior.
• Uma access_credential emitida pelo seu backend, como em criar verificação.
• O bundle identifier do app registrado e verificado em Integrações → Segurança.

A chave de API nunca vai para o app. Ele recebe só a access_credential, que vale para uma verificação e expira.

Configure o projeto

1. Adicione o pacote

   Em File → Add Package Dependencies, informe a URL do repositório e fixe a versão exata:

   https://github.com/Legitimuz-Tech/legitimuz-sdk-ios-dist
   

   O produto a adicionar é LegitimuzSDK. Ele traz o FaceTecSDK junto, não adicione o FaceTec separadamente.

2. Declare o uso da câmera

   Sem NSCameraUsageDescription, o app é encerrado pelo sistema ao pedir a câmera.

   Info.plist

   <key>NSCameraUsageDescription</key>
   <string>Precisamos da câmera para fotografar seu documento e confirmar que é você.</string>
   

   Escreva o texto para o titular, não para a App Review. É ele que aparece no alerta.

3. Peça a permissão antes de abrir

   VerificacaoViewController.swift

   import AVFoundation
   
   private func pedirCameraEIniciar() {
       switch AVCaptureDevice.authorizationStatus(for: .video) {
       case .authorized:
           iniciarVerificacao()
       case .notDetermined:
           AVCaptureDevice.requestAccess(for: .video) { [weak self] concedida in
               DispatchQueue.main.async {
                   concedida ? self?.iniciarVerificacao() : self?.mostrarExplicacao()
               }
           }
       default:
           mostrarExplicacao()
       }
   }
   
4. Busque a credencial no seu backend

   VerificacaoService.swift

   func obterCredencial(refId: String) async throws -> String {
       var req = URLRequest(url: URL(string: "https://seu-backend.exemplo.com.br/verificacoes")!)
       req.httpMethod = "POST"
       req.setValue("application/json", forHTTPHeaderField: "Content-Type")
       req.httpBody = try JSONEncoder().encode(["ref_id": refId])
   
       let (dados, _) = try await URLSession.shared.data(for: req)
       return try JSONDecoder().decode(RespostaVerificacao.self, from: dados).accessCredential
   }
   
5. Abra a sessão

   VerificacaoViewController.swift

   private func iniciarVerificacao() {
       Task {
           let credencial = try await service.obterCredencial(refId: "pedido-4471")
   
           let verificacao = LegitimuzVerification(accessCredential: credencial)
           verificacao.onEvent = { nome, _ in
               print("Legitimuz: \(nome)")
           }
           verificacao.onComplete = { [weak self] _ in
               // O desfecho confiável chega pelo webhook, no seu backend.
               self?.dismiss(animated: true)
           }
           verificacao.onError = { codigo, mensagem in
               print("Legitimuz erro \(codigo): \(mensagem)")
           }
   
           present(verificacao.viewController, animated: true)
       }
   }
   

Confira que funcionou

O fluxo abre na primeira etapa e o console registra session.started. No dashboard, a verificação sai de not_opened e passa a started.

Os eventos

Os mesmos da web. O catálogo completo está em eventos.

Evento	Quando dispara
session.started	o fluxo abriu a primeira etapa
session.stepTransitioned	o servidor trocou a etapa
document.capture.completed	a captura do documento foi enviada
liveness.completed	a prova de vida foi concluída
session.completed	o fluxo terminou
session.error	um erro ocorreu na sessão

Não decida nada a partir de session.completed. O desfecho confiável chega ao seu backend por verification.decided.

Casos de borda

O titular negou a câmera

No iOS a negativa é definitiva dentro do app: só as Ajustes resolvem. Explique por que a câmera é necessária e leve o titular para lá.

if let url = URL(string: UIApplication.openSettingsURLString) {
    UIApplication.shared.open(url)
}

O app foi para segundo plano

A sessão é retomável: ao voltar, ela reabre na etapa onde o titular parou, desde que a credencial não tenha expirado.

A credencial expirou

onError chega com um código de credencial inválida. Peça uma credencial nova ao seu backend e comece outra sessão, não reaproveite a antiga.

A sessão recusa abrir

Quase sempre é origem. Confirme que o bundle identifier está registrado e verificado, e que a verificação foi criada com o integration_origin_public_id dessa origem.

Próximo passo

Android

O mesmo fluxo em Kotlin.

Receber a decisão

Onde o desfecho realmente chega.