iOS Inline Inquiries Guide

1
let inquiry = Inquiry
2
    .from(templateId: "itmpl_EXAMPLE", delegate: self)
3
    .environment(.sandbox)
4
    .build()
5
6
guard let inlineViewController = inquiry.startInline() else {
7
    // Inquiry is no longer valid (already started or completed)
8
    return
9
}

1
// In a navigation stack
2
navigationController?.pushViewController(inlineViewController, animated: true)
3
4
// In a tab or container view controller
5
addChild(inlineViewController)
6
containerView.addSubview(inlineViewController.view)
7
inlineViewController.didMove(toParent: self)

1
inlineViewController.navigationItem.title = "Identity Verification"
2
inlineViewController.navigationItem.leftBarButtonItem = UIBarButtonItem(
3
    image: UIImage(systemName: "chevron.backward"),
4
    style: .plain,
5
    target: self,
6
    action: #selector(handleBack)
7
)
8
inlineViewController.navigationItem.rightBarButtonItem = UIBarButtonItem(
9
    image: UIImage(systemName: "xmark"),
10
    style: .plain,
11
    target: self,
12
    action: #selector(handleCancel)
13
)
14
inlineViewController.delegate = self

1
@objc func handleBack() {
2
    inlineViewController.navigateBack()
3
}
4
5
@objc func handleCancel() {
6
    inlineViewController.presentCancelModal()
7
}

1
extension MyViewController: InquiryDelegate {
2
    func inquiryComplete(inquiryId: String, status: String, fields: [String: InquiryField]) {
3
        // User completed the flow.
4
5
        // dismiss inline flow
6
        navigationController?.popViewController(animated: true)
7
    }
8
9
    func inquiryCanceled(inquiryId: String?, sessionToken: String?) {
10
        // User cancelled the flow.
11
12
        // dismiss inline flow
13
        navigationController?.popViewController(animated: true)
14
    }
15
16
    func inquiryError(_ error: PersonaError) {
17
        // An error prevented the user from completing the flow.
18
19
        // dismiss inline flow
20
        navigationController?.popViewController(animated: true)
21
    }
22
}

1
extension MyViewController: PersonaInlineDelegate {
2
    func navigationStateDidUpdate(navigationState: PersonaInlineNavigationState) {
3
        backButton?.isEnabled = navigationState.backButtonEnabled
4
        cancelButton?.isEnabled = navigationState.cancelButtonEnabled
5
    }
6
7
    func onReady() {
8
        // Called when the first step is ready to display.
9
        // Use this to skip showing a loading state.
10
    }
11
}

1
final class MyViewController: UIViewController {
2
    private var inlineViewController: PersonaInlineViewController?
3
4
    func startVerification() {
5
        let inquiry = Inquiry
6
            .from(templateId: "itmpl_EXAMPLE", delegate: self)
7
            .build()
8
        guard let vc = inquiry.startInline() else { return }
9
        vc.delegate = self
10
        inlineViewController = vc
11
        // Don't push yet — wait for onReady().
12
    }
13
}
14
15
extension MyViewController: PersonaInlineDelegate {
16
    func onReady() {
17
        guard let inlineViewController else { return }
18
        navigationController?.pushViewController(inlineViewController, animated: true)
19
    }
20
}

1
extension MyViewController: InquiryDelegate {
2
    func inquiryEventOccurred(event: InquiryEvent) {
3
        switch event {
4
        case let .start(startEvent):
5
            // Flow initialized — startEvent exposes inquiryId and sessionToken.
6
            print("Inquiry started: \(startEvent.inquiryId)")
7
8
        case let .pageChange(pageChange):
9
            // User moved to a new step or page within the flow.
10
            // pageChange.name is the step name configured in your Inquiry Template;
11
            // pageChange.path describes the current page within that step.
12
            updateProgressIndicator(forStepName: pageChange.name)
13
        }
14
    }
15
}