ID Card

Declaration

func scanIDCard(
    on viewController: UIViewController, 
    for country: Country, 
    doneLaunching: SybrinIdentity.doneLaunchingType? = nil, 
    success: SybrinIdentity.idCardSuccessCallbackType? = nil, 
    failure: SybrinIdentity.failureCallbackType? = nil, 
    cancel: SybrinIdentity.cancelCallbackType? = nil
)

To view all the type aliases, go to the SybrinIdentity class

Handling the doneLaunching , success , failureor cancel callbacks are optional but recommended.

To find out if we support a country, check out Supported Documents! To request support for a country, contact us!

Calling the function

Parameters

Type	Description
UIViewController	The controller you would like to present on.
Country	The country you would like to scan for.

Handling callback responses

doneLaunching

The doneLaunching callback will be executed after the view controller has successfully launched, or if the view controller failed to launch.

Parameters:

Type	Description
Bool	true if the view controller presented successfully; otherwise, false.
String?	If an error occurs, a message describing the error; otherwise, nil.

Example:

doneLaunching: { (didLaunch, message) in
    if didLaunch {
        print("Launched successfully!")
    } else if let message = message {
        print("Failed to launch because \(message)")
    }
}

success

The success callback will be executed after scanning has finished and the view controller has been dismissed.

Parameters:

Type	Description
IDCardModel	An object containing the results of the scanned id card.

As explained in Features, the success callback will always return the country specific model but in its parent class form. However, this can be casted to the country specific model to access that country model's specific properties.

This is not required, but is recommended if you would like to access the country model's specific properties.

Let's say that you provide the scanIDCard function with the .SouthAfrica country parameter. The result will be of type SouthAfricaIDCardModel, but is returned in its parent form IDCardModel. To access all the data specific to SouthAfricaIDCardModel you will need to cast the IDCardModel to that type.

Example:

success: { (model) in
    if let southAfricaIDCard = model as? SouthAfricaIDCardModel {
        print("This is a south african id card model! \(southAfricaIDCard.rsaCode)")
    }
}

failure

The failure callback will be executed after scanning has failed and the view controller has been dismissed.

Parameters:

Type	Description
String?	A message describing the error.

If you would like to report a bug, contact us!

Example:

failure: { (message) in
    print("Scan id card failed because \(message)")
}

cancel

The cancel callback will be executed after the user has dismissed the view controller and before scanning could finish.

Parameters:

None

Example:

cancel: {
    print("Scan id card canceled")
}

Full Example

SybrinIdentity.shared.scanIDCard(on: self, for: .SouthAfrica) 
{ (didLaunch, message) in
    if didLaunch {
        print("Launched successfully!")
    } else if let message = message {
        print("Failed to launch because \(message)")
    }
} success: { (model) in
    if let model = model as? SouthAfricaIDCardModel {
        print("Scan id card success: \(model.rsaCode ?? "")")
    }
} failure: { (message) in
    print("Scan id card failed because \(message)")
} cancel: {
    print("Scan id card canceled")
}