NetverifyUIControllerDelegate

@protocol NetverifyUIControllerDelegate <NSObject>

Protocol that has to be implemented when using NetverifyUIControllerDelegate.

  • Called when the SDK and all resources are loaded. Error will be null in case of success. Always before netverifyUIController:didDetermineAvailableCountries:suggestedCountry:

    • - parameter: netverifyUIController the controller instance

    Declaration

    Objective-C

    - (void)netverifyUIController:
                (NetverifyUIController *_Nonnull)netverifyUIController
        didFinishInitializingWithError:(NetverifyError *_Nullable)error;

    Swift

    func netverifyUIController(_ netverifyUIController: NetverifyUIController, didFinishInitializingWithError error: NetverifyError?)

    Parameters

    error

    holds more detailed information about the error reason

  • This delegate is invoked when the end-user’s consent to Jumio’s privacy policy is legally required. Please call “userConsentGiven:” when the end-user has accepted.

    Declaration

    Objective-C

    - (void)netverifyUIController:
                (NetverifyUIController *_Nonnull)netverifyUIController
        shouldRequireUserConsentWithURL:(NSURL *_Nonnull)url;

    Swift

    func netverifyUIController(_ netverifyUIController: NetverifyUIController, shouldRequireUserConsentWith url: URL)

    Parameters

    netverifyUIController

    the controller instance

    url

    url where the user should be redirected for Jumio Privacy Policy

  • Called as soon as the SDK is set up and the required information is loaded and provides the available countries and document types. Only the valid NetverifyCountries and NetverifyDocuments which validate with the settings used in the NetverifyConfiguration will be provided here.

    Declaration

    Objective-C

    - (void)netverifyUIController:
                (NetverifyUIController *_Nonnull)netverifyUIController
        didDetermineAvailableCountries:(NSArray *_Nonnull)countries
                      suggestedCountry:(NetverifyCountry *_Nullable)country;

    Swift

    func netverifyUIController(_ netverifyUIController: NetverifyUIController, didDetermineAvailableCountries countries: [Any], suggestedCountry country: NetverifyCountry?)

    Parameters

    netverifyUIController

    the controller instance

    countries

    array with NetverifyCountry objects

    country

    is the suggested country object based on phone localization.

  • After setupWithDocument: is called on NetverifyUIController the scan view controller for the required scan side will be provided. While the order of the scan view controllers (Front, Back, Face) is predefined only the required ones will return in this method. The NetverifyCustomScanViewController should be presented and dismissed by the client application.

    Declaration

    Objective-C

    - (void)netverifyUIController:
                (NetverifyUIController *_Nonnull)netverifyUIController
        didDetermineNextScanViewController:
            (NetverifyCustomScanViewController *_Nonnull)scanViewController
                                isFallback:(BOOL)isFallback;

    Swift

    func netverifyUIController(_ netverifyUIController: NetverifyUIController, didDetermineNextScanViewController scanViewController: NetverifyCustomScanViewController, isFallback: Bool)

    Parameters

    netverifyUIController

    the controller instance

    scanViewController

    the viewController which has to be presented

    isFallback

    determines if the scan view controller was switched to fallback

  • Called after all scan view controllers did finish scanning. Network tasks are still ongoing. We advice to show a loading animation. In case a nework error occurs further action is required (retry or cancel) in netverifyUIController:didDetermineError:retryPossible:

    Declaration

    Objective-C

    - (void)netverifyUIControllerDidCaptureAllParts:
        (NetverifyUIController *_Nonnull)netverifyUIController;

    Swift

    func netverifyUIControllerDidCaptureAllParts(_ netverifyUIController: NetverifyUIController)

    Parameters

    netverifyUIController

    the controller instance

  • Called whenever an error (due to network, ressources, permissions, …) occured. Please find more information about this in our gihub implementation guide at https://github.com/Jumio/mobile-sdk-ios/blob/master/docs/integration_netverify-fastfill.md#error .

    Declaration

    Objective-C

    - (void)netverifyUIController:
                (NetverifyUIController *_Nonnull)netverifyUIController
                didDetermineError:(NetverifyError *_Nonnull)error
                    retryPossible:(BOOL)retryPossible;

    Swift

    func netverifyUIController(_ netverifyUIController: NetverifyUIController, didDetermineError error: NetverifyError, retryPossible: Bool)

    Parameters

    netverifyUIController

    the controller instance

    error

    holds more detailed information about the error reason

    retryPossible

    defines if displaying a retry-button makes sense or if the error is final

  • Called when the SDK finished with success.

    Declaration

    Objective-C

    - (void)netverifyUIController:
                (NetverifyUIController *_Nonnull)netverifyUIController
        didFinishWithDocumentData:(NetverifyDocumentData *_Nonnull)documentData
                    scanReference:(NSString *_Nonnull)scanReference
                        accountId:(NSString *_Nullable)accountId
             authenticationResult:(BOOL)authenticationResult;

    Swift

    func netverifyUIController(_ netverifyUIController: NetverifyUIController, didFinishWith documentData: NetverifyDocumentData, scanReference: String, accountId: String?, authenticationResult: Bool)

    Parameters

    netverifyUIController

    the controller instance

    documentData

    data containing the extracted information

    scanReference

    the unique identifier of the scan session

    accountId

    Account Id, if available

    authenticationResult

    Bool identifies if Authentication passed successfully

  • Called when the SDK canceled.

    Declaration

    Objective-C

    - (void)netverifyUIController:
                (NetverifyUIController *_Nonnull)netverifyUIController
               didCancelWithError:(NetverifyError *_Nullable)error
                    scanReference:(NSString *_Nullable)scanReference
                        accountId:(NSString *_Nullable)accountId;

    Swift

    func netverifyUIController(_ netverifyUIController: NetverifyUIController, didCancelWithError error: NetverifyError?, scanReference: String?, accountId: String?)

    Parameters

    netverifyUIController

    the controller instance

    error

    NSObject holds more detailed information about the error reason

    scanReference

    the unique identifier of the scan session

    accountId

    Account Id, if available