Onboarding (KYC/KYB)

3 min read

This guide adds the Footprint onboarding flow for KYC (Know Your Customer) and KYB (Know Your Business) to your Android app. Install the SDK first: Installation.

Start an onboarding

  1. Create an onboarding session. Call POST /onboardings and keep the onboarding session token it returns, such as obtok_UxM6Vbvk2Rcy1gzcSuXgk3sj3L9I0pAnNH.
  2. Launch the flow. When the user taps a button, for example, call Onboarding.initialize with your activity context, the onboardingSessionToken, and an onComplete callback.
kotlin
1Button(
2    onClick = {
3        Onboarding.initialize(
4            context = context,
5            onboardingSessionToken = "YOUR AUTH TOKEN", 
6            onComplete = { validationToken ->
7                println("Onboarding completed successfully. Validation token: $validationToken")
8            }
9        )
10    }
11) {
12    Text("Launch Footprint onboarding flow")
13}

Handle the result

When the user completes the flow, onComplete receives a validationToken. Post it to your backend for further processing.

The SDK also reports cancellation and errors. Pass onCancel and onError to initialize:

kotlin
1Button(
2    onClick = {
3        Onboarding.initialize(
4            context = context,
5            onboardingSessionToken = "YOUR AUTH TOKEN",
6            onComplete = { validationToken ->
7                println("Onboarding completed successfully. Validation token: $validationToken")
8            },
9            onCancel = {
10                println("Onboarding was canceled by the user")
11            },
12            onError = { error ->
13                println("Onboarding error: $error")
14            }
15        )
16    }
17) {
18    Text("Launch Footprint onboarding flow")
19}

Customize the appearance

Pass an appearance object to initialize to change the look of the flow:

kotlin
1Button(
2    onClick = {
3        Onboarding.initialize(
4            context = context,
5            onboardingSessionToken = "YOUR AUTH TOKEN",
6            onComplete = { validationToken ->
7                println("Onboarding completed successfully. Validation token: $validationToken")
8            },
9            onCancel = {
10                println("Onboarding was canceled by the user")
11            },
12            onError = { error ->
13                println("Onboarding error: $error")
14            },
15            appearance = FootprintAppearance(
16                variables = FootprintAppearanceVariables(
17                    borderRadius = "8px",
18                    buttonPrimaryBg = "#315E4C",
19                    colorSuccess = "#315E4C",
20                    colorError = "#E33D19"
21                )
22            )
23        )
24    }
25) {
26    Text("Launch Footprint onboarding flow")
27}

The customization guide lists every variable.

Available props

Variable Description
onboardingSessionToken The onboarding session token you created.
context Your activity context.
onComplete Optional. Triggered after the user completes the onboarding flow. You receive a validationToken that your backend can exchange with Footprint to see the fp_id, the login method used, and the KYC status.
onError Optional. Called when there was an unrecoverable error during the onboarding flow.
onCancel Optional. Triggered when the user abandons the flow.
appearance Optional. A FootprintAppearance object that customizes the look of your integration.
l10n Optional. The desired localization, as a FootprintL10n object. See Localization configuration.

Next steps

  • Handle the decision validates the token on your backend and reads the onboarding status.
  • Changelog lists notable releases of the Android SDK.