iOS

// Package.swift of your app (or Xcode → File → Add Package Dependencies… → https://github.com/okyc-team/okyc-ios).
dependencies: [
    .package(url: "https://github.com/okyc-team/okyc-ios.git", from: "0.1.0"),
],
targets: [
    .target(name: "YourApp", dependencies: [.product(name: "OKYC", package: "okyc-ios")]),
]

pod 'OKYC', '~> 0.1'

<!-- The flow uses the camera (documents, selfie) and may ask for the microphone (liveness). -->
<key>NSCameraUsageDescription</key>
<string>We use the camera to capture your documents and a selfie to verify your identity.</string>
<key>NSMicrophoneUsageDescription</key>
<string>The verification flow may request microphone access for the liveness check.</string>

let config = OkycConfig(
    sessionURL: url,        // the `url` your backend got from POST /v1/sessions
    locale: nil,            // "en" or "hi"; nil keeps the session's language
    theme: theme,           // .light, .dark or .system (default)
    blockScreenshots: true, // cover the flow in the app switcher and while recording (default)
    autoCloseDelay: 2,      // seconds the result screen stays visible after `complete`; nil = stay open
    presentation: .sheet    // or .fullScreen
)

.okycVerification(
    isPresented: $presenting, // set to true to present the flow
    config: config,
    onEvent: { event in handleEvent(event) },
    onResult: { result in handleResult(result) } // called exactly once per presentation
)

private func handleResult(_ result: OkycResult) {
    switch result {
    case let .completed(sessionId, status):
        // The applicant finished. Confirm the decision on your backend (webhook or GET /v1/sessions/:id).
        show("completed \(sessionId) \(status)")
    case let .cancelled(sessionId):
        // Closed before finishing; the same session URL can be opened again.
        show("cancelled \(sessionId ?? "-")")
    case let .failed(code, message, _):
        // `code` is one of OkycErrorCode (network_error, load_failed, …).
        show("failed \(code) \(message)")
    }
}

private func handleEvent(_ event: OkycEvent) {
    // Progress only (ids and statuses, never personal data). The result arrives in handleResult.
    switch event.kind {
    case .stepStarted, .stepCompleted: log.append("\(event.kind.rawValue) \(event.payload["step"] ?? "")")
    case .error: log.append("error \(event.payload["code"] ?? "")") // recoverable; the flow keeps running
    default: log.append(event.kind.rawValue)
    }
}