Skip to main content

​
Overview

This guide shows you how to integrate the MetaMap SDK into your UIKit-based iOS application using the MetaMapButton component.

​
Prerequisites

  • MetaMap SDK installed via CocoaPods
  • iOS 13.0 or later
  • Swift 5.7 or later

​
Implementation

​
Basic Setup

Here’s a complete implementation of MetaMap verification in a UIKit view controller: 
import UIKit
import MetaMapSDK

class ViewController: UIViewController {

	override func viewDidLoad() {
		super.viewDidLoad()
		self.setupMetaMapButton()
	}

    private func setupMetaMapButton() {

      //init button
      let metaMapButton = MetaMapButton()

      //add button action
            metaMapButton.addTarget(self, action: #selector(self.metaMapButtonAction), for: .touchUpInside)

      //set view of button
            metaMapButton.frame = CGRect(x: 20, y: self.view.frame.size.height/2 - 50, width: view.frame.size.width - 40, height: 50)

      //add button to yours view
      view.addSubview(metaMapButton)

      //set delegate to get result
      MetaMapButtonResult.shared.delegate = self

    }

      @objc private func metaMapButtonAction() {
	//set params to showMetaMapFlow
	MetaMap.shared.showMetaMapFlow(clientId: "YOUR_CLIENT_ID",
				flowId: "YOUR_FLOW_ID",
				metadata: ["key1": "value1", "key2": 123])
	}
}

//MARK: MetaMapButtonResultDelegate
extension ViewController: MetaMapButtonResultDelegate {

    func verificationSuccess(identityId: String?, verificationID: String?) {
		print("MetaMap Verification Success \(identityId)")
	}

	func verificationCancelled() {
		print("MetaMap Verification Cancelled")
	}
}

​
Key Components

​
1. Initialize MetaMapButton

Create an instance of MetaMapButton in your view controller: 
let metaMapButton = MetaMapButton()

​
2. Add Button Action

Connect the button to an action handler: 
metaMapButton.addTarget(self, action: #selector(self.metaMapButtonAction), for: .touchUpInside)

​
3. Configure Button Layout

Set the button’s frame and add it to your view: 
metaMapButton.frame = CGRect(x: 20, y: self.view.frame.size.height/2 - 50, width: view.frame.size.width - 40, height: 50)
view.addSubview(metaMapButton)

​
4. Set Delegate

Assign the delegate to receive verification results: 
MetaMapButtonResult.shared.delegate = self

​
5. Launch Verification Flow

In your button action handler, call showMetaMapFlow with your credentials: 
@objc private func metaMapButtonAction() {
    MetaMap.shared.showMetaMapFlow(
        clientId: "YOUR_CLIENT_ID",
        flowId: "YOUR_FLOW_ID",
        metadata: ["key1": "value1", "key2": 123]
    )
}

​
Handling Results

Implement the MetaMapButtonResultDelegate protocol to handle verification results: 
extension ViewController: MetaMapButtonResultDelegate {
    func verificationSuccess(identityId: String?, verificationID: String?) {
        print("MetaMap Verification Success \(identityId ?? "")")
        // Handle successful verification
    }

    func verificationCancelled() {
        print("MetaMap Verification Cancelled")
        // Handle cancellation
    }
}

​
Delegate Methods

  • verificationSuccess(identityId:verificationID:) - Called when verification completes successfully
  • verificationCancelled() - Called when the user cancels the verification process

​
Parameters

​
showMetaMapFlow Parameters

ParameterTypeRequiredDescription
clientIdStringYesYour MetaMap client ID
flowIdStringYesThe verification flow ID
metadataDictionaryNoAdditional metadata and customization options

​
Next Steps

Build docs developers (and LLMs) love

Get started for freeTalk to us