Skip to main content

MetaMap iOS SDK

Add secure identity verification to your iOS app in minutes. Verify documents, biometrics, and identity with a production-ready SDK trusted by enterprises worldwide.

MetaMap Logo

Quick Start

Get up and running with MetaMap in your iOS app in just a few steps

1

Install the SDK

Add MetaMap to your project using CocoaPods. Add this line to your Podfile:
Podfile
pod 'MetaMapSDK', '3.23.14'
Then run:
Terminal
pod install
2

Import and initialize

Import the SDK in your view controller and set up the MetaMap button:
ViewController.swift
import UIKit
import MetaMapSDK

class ViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        setupMetaMapButton()
    }
    
    private func setupMetaMapButton() {
        let metaMapButton = MetaMapButton()
        metaMapButton.addTarget(self, action: #selector(metaMapButtonAction), for: .touchUpInside)
        metaMapButton.frame = CGRect(x: 20, y: self.view.frame.size.height/2 - 50, 
                                    width: view.frame.size.width - 40, height: 50)
        view.addSubview(metaMapButton)
        
        MetaMapButtonResult.shared.delegate = self
    }
    
    @objc private func metaMapButtonAction() {
        MetaMap.shared.showMetaMapFlow(
            clientId: "YOUR_CLIENT_ID",
            flowId: "YOUR_FLOW_ID",
            metadata: ["key": "value"]
        )
    }
}
3

Handle verification results

Implement the delegate protocol to receive verification callbacks:
ViewController.swift
extension ViewController: MetaMapButtonResultDelegate {
    func verificationSuccess(identityId: String?, verificationID: String?) {
        print("Verification successful: \(identityId ?? "")")
        // Handle successful verification
    }
    
    func verificationCancelled() {
        print("Verification cancelled")
        // Handle cancellation
    }
}
4

Configure permissions

Add required permissions to your Info.plist:
Info.plist
<key>NSCameraUsageDescription</key>
<string>MetaMap needs access to your Camera</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>MetaMap needs access to your media library</string>
<key>NSMicrophoneUsageDescription</key>
<string>MetaMap needs access to your Microphone</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>MetaMap will use your location information to provide best possible verification experience.</string>

Key Features

Everything you need to verify user identity in your iOS application

Document Verification

Verify government-issued IDs, passports, and driver’s licenses with automatic extraction

Biometric Verification

Advanced facial recognition with liveness detection to prevent spoofing

Phone & Email

Verify user contact information with OTP-based authentication

Multi-Flow Support

Create custom verification workflows tailored to your business needs

UI Customization

Customize colors, fonts, and button styles to match your brand

Multi-Language

Built-in support for 10+ languages with automatic device locale detection

Resources

Additional documentation and support resources

API Reference

Complete reference documentation for all classes, methods, and protocols

Changelog

Track updates, new features, and bug fixes across SDK versions

Troubleshooting

Common issues and solutions for integration problems

Migration Guide

Upgrade from older SDK versions with step-by-step instructions

Ready to get started?

Add secure identity verification to your iOS app today. Follow our quickstart guide to integrate MetaMap in minutes.

View Quickstart Guide

Build docs developers (and LLMs) love