Native

SDK Version

Latest GlobalPass iOS SDK version: 2.5

Requirements

iOS 13+
Xcode 15.1+

CocoaPods installation

Configure Podfile

In order to download FaceTec dependency, provide cocoapods-azure-universal-packages configuration at the beginning of your Podfile as described below:

plugin 'cocoapods-azure-universal-packages', {
  :organization => 'https://dev.azure.com/isun-ag'
}

Declare source URLs so Cocoapods be able to download dependencies podspec files.

source 'https://cdn.cocoapods.org'
source 'https://dev.azure.com/isun-ag/GlobalPassApp-Public/_git/GlobalPassApp-sdk-ios-private-specs'

Under the application module declare the following dependencies:

pod 'GlobalPass', '~> 2.5'
pod 'FaceTecSDK', :http => 'https://dev.azure.com/isun-ag/368936e7-5cb5-4092-96c5-fe9942e2c3e1/_apis/packaging/feeds/FaceTecSDK/upack/packages/facetecsdk/versions/0.0.6'
pod `lottie-ios`, `~> 4.3.4`

To the end of application module declaration add these lines to configure build process:

  post_install do |installer|
    installer.pods_project.targets.each do |target|
      target.build_configurations.each do |config|
        config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
      end
    end
  end

To properly download FaceTec dependency, we need to configure azure-cli. First step is downloading the utility:

$ brew update && brew install azure-cli

After that, run login command:

$ az devops login

info

When asked for credentials, put the repository access token, which will be provided by GlobalPass Support.

Once authorization succeeds, install cocoapods azure plugin with the following command:

$ gem install cocoapods-azure-universal-packages

In the end, generate your project again with pods:

$ pod install

Troubleshooting

If you are having problems with the pod cache, please follow this answer. If you link the GlobalPass framework to the application target manually, please make sure that you link the framework again after upgrading the SDK version.

Project setup

`Info.plist` configuration

GlobalPass SDK makes the use of location, NFC and camera capabilities when they are requested. To properly ask the user about access to these features, add the following keys into your project's Info.plist file:

Info.plist
<key>NFCReaderUsageDescription</key>
<string>Provide you description here</string>
<key>NSCameraUsageDescription</key>
<string>Provide you description here</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>Provide you description here</string>
<key>com.apple.developer.nfc.readersession.iso7816.select-identifiers</key>
<array>
<string>A0000002471001</string>
<string>A0000002472001</string>
<string>00000000000000</string>
</array>

important

Please change the descriptions under NFCReaderUsageDescription, NSCameraUsageDescription and NSLocationWhenInUseUsageDescription in the file above. This is important to pass App Store review process for your application.

Usage

Regular Screening Flow

do {
    callback = try GlobalPassSDK.setupScreening(environment: environment, screeningToken: screeningToken)
} catch {
    print(error)
}
DispatchQueue.main.async {
    guard let viewController = GlobalPassSDK.startScreening(externalID: nil) else {
        return
    }
    viewController.modalPresentationStyle = .overFullScreen
    self.present(viewController, animated: true, completion: nil)
}

Call to this method (setupScreening(environment:screeningToken:)) returns a closure. You should call it in order to make SDK know that you have finished a KYC flow. Pass to externalID a string to associate it with the KYC session record or nil to leave it empty.

try GlobalPassSDK.setupScreening(
    environment: environment,
    screeningToken: screeningToken
)

Call to this method (startScreening(completion:)) returns an instance of UIViewController. Completion you pass here is called when SDK finishes the KYC flow.

GlobalPassSDK.startScreening(externalID: "some external id")

You should present this controller over the rootViewController.

And that’s it. After the KYC flow is passed SDK dismisses its view controller and calls the callback you passed earlier.

Split Screening Flow

If you are using Split flow instead of Regular, call startSplitScreening method, passing there required part of the widget (identity or address). The rest of the steps are the same as in the case of the Regular screening flow.

do {
    callback = try GlobalPassSDK.setupScreening(environment: environment, screeningToken: screeningToken)
} catch {
    print(error)
}
DispatchQueue.main.async {
    guard let viewController = GlobalPassSDK.startSplitScreening(type: .address, externalID: nil) else {
        return
    }
    viewController.modalPresentationStyle = .overFullScreen
    self.present(viewController, animated: true, completion: nil)
}

Instant Biometrics Flow

do {
    callback = try GlobalPassSDK.setupInstant(environment: environment, instantBiometricsId: instantBiometricsId)
} catch {
    print(error)
}
DispatchQueue.main.async {
    guard let viewController = GlobalPassSDK.startInstant() else {
        return
    }
    viewController.modalPresentationStyle = .overFullScreen
    self.present(viewController, animated: true, completion: nil)
}

Call to this method (setupInstant(environment:instantBiometricsId:)) returns a closure. You should call it in order to make SDK know that you have finished a KYC flow.

try GlobalPassSDK.setupInstant(
    environment: environment,
    instantBiometricsId: instantBiometricsId
)

Call to this method (startInstant(completion:)) returns an instance of UIViewController. Completion you pass here is called when SDK finishes the KYC flow.

GlobalPassSDK.startInstant(completion: { _, _ in callback?() })

You should present this controller over the rootViewController.

And that’s it. After the KYC flow is passed SDK dismisses its view controller and calls the callback you passed earlier.

Localisation

To specify the required localisation, provide the localeIdentifier parameter with a string value containing the locale identifier in the function call:

do {
    callback = try GlobalPassSDK.setupScreening(environment: environment, screeningToken: screeningToken, localeIdentifier: "en")
} catch {
    print(error)
}
DispatchQueue.main.async {
    guard let viewController = GlobalPassSDK.startSplitScreening(type: .address, externalID: nil) else {
        return
    }
    viewController.modalPresentationStyle = .overFullScreen
    self.present(viewController, animated: true, completion: nil)
}

Available locales:

en - English
de - German
es-MX - Spanish
it - Italian
lt - Lithuanian
pt-BR - Portuguese
ru - Russian
ar - Arabic
zh-CN - Chinese Simplified

note

If an unsupported locale will be provided, the SDK will fallback to English.

localeIdentifier parameter is defined for static builders. Use the method without this parameter to use the default English localisation.

GlobalPassSDK.setupScreening(environment:screeningToken:) // Default English
GlobalPassSDK.setupScreening(environment:screeningToken:localeIdentifier:) // Provided Localisation
GlobalPassSDK.setupInstant(environment:instantBiometricsId:) // Default English
GlobalPassSDK.setupInstant(environment:instantBiometricsId:localeIdentifier:) // Provided Localisation

Customisation

From version 2.0, SDK provides GPFontConfiguration type, specifically designed to facilitate the customization of font styles. This configuration allows you to define the regular and semibold font styles. Other configuration aspects such as colors and component sizes can be configured in the GlobalPass Portal.

try? GlobalPassSDK.setupScreening(
    environment: .dev,
    screeningToken: "...",
    fontConfiguration: GPFontConfiguration(
        regular: .systemFont(ofSize: 1.0, weight: .regular),
        semibold: .systemFont(ofSize: 1.0, weight: .semibold)
    )
)

From version 2.0, the SDK supports both Light and Dark modes. If your application does not support dark mode, you can disable it by following instructions in this article.

Callback Management

SDK provides the ability to track navigation events between screens. The list of possible events is provided through GPEvents enumeration.

public enum GPEvents: Int {
    case commentsControllerPresented                      // 0
    case initialControllerPresented                       // 1
    case welcomeControllerPresented                       // 2
    case faceTecGuideControllerPresented                  // 3
    case screeningFaceTecInitialisingControllerPresented  // 4
    case instantFaceTecInitialisingControllerPresented    // 5
    case instantFaceTecProcessingControllerPresented      // 6
    case screeningFaceTecProcessingControllerPresented    // 7
    case faceTecFailureControllerPresented                // 8
    case faceTecSessionFailureControllerPresented         // 9
    case documentSelectionControllerPresented             // 10
    case documentGuideControllerPresented                 // 11
    case documentPhotoControllerPresented                 // 12
    case nfcControllerPresented                           // 13
    case personalDetailsControllerPresented               // 14
    case addressDetailsControllerPresented                // 15
    case proofOfAddressControllerPresented                // 16
    case countriesListControllerPresented                 // 17
    case instantCompleteControllerPresented               // 18
    case screeningCompleteControllerPresented             // 19
    case instantFinishControllerPresented                 // 20
    case screeningFinishControllerPresented               // 21
    case terminated                                       // 22
    case cancelledSession                                 // 23
}

To subscribe to an event, use the completion parameter when initialising an SDK session:

try GlobalPassSDK(
    environment: .dev,
    screeningToken: "...",
    completion: { event in
        // handle event
    }
)

Privacy

The GlobalPass SDK collects sensitive user data, including location and personal details, to support KYC processes. This data is exclusively used within the SDK and is not shared with any third parties. To align with Apple's privacy standards, the SDK includes a privacy manifest file detailing all types of data collected.

Security

Starting from version 2.0, the GlobalPass SDK bundle incorporates a code signature, endorsed by the Apple Developer Program.

Native

CocoaPods installation​

Configure Podfile​

Login into azure cli​

Troubleshooting​

Project setup​

Info.plist configuration​

Usage​

Regular Screening Flow​

Split Screening Flow​

Instant Biometrics Flow​

Localisation​

Customisation​

Callback Management​

Privacy​

Security​