For the complete documentation index, see llms.txt. This page is also available as Markdown.

Hosted KYC

Hosted KYC lets you run uqudo’s onboarding flow without building your own onboarding user interface. You create and manage the setup in the Customer Portal, while uqudo hosts the onboarding journey for your end-users.

How Hosted KYC works

  1. Create a Hosted KYC configuration in the Customer Portal.

  2. Choose how end-users will complete onboarding:

    • Mobile Browser

    • Mobile App

  3. Configure the workflow, text, branding, onboarding settings, and delivery settings.

  4. Share the generated onboarding link with your end-users.

  5. The end-user completes the onboarding journey on a mobile phone.

  6. uqudo sends the result to your configured webhook, makes the session available in the Customer Portal, and can also send a notification email.

  7. If a return URL is configured, the end-user is redirected back to your website or application.

Before you start

Before creating your Hosted KYC configuration, decide:

  • which documents you want to accept

  • whether you need Face Authentication

  • whether you need Background Screening

  • whether you need Lookup or NFC

  • whether you want to receive results automatically through a webhook

  • whether you want a notification email for your operations team

  • whether you want the end-user to return to a specific page after completion

If you are not sure whether a feature is enabled for your account, contact your uqudo representative.

Create a configuration

  1. Open the Customer Portal.

  2. Go to Hosted KYC.

  3. Click Create Configuration.

  4. Choose one of the available onboarding channels:

    • Mobile Browser

    • Mobile App

  5. Enter a clear configuration name.

  6. Save the configuration.

After the configuration is created, continue with the setup pages inside that configuration.

Choose the onboarding channel

Mobile Browser

Choose Mobile Browser when you want the end-user to complete onboarding in the mobile browser using the phone camera and uqudo Web SDK.

This is usually the fastest option to launch because the user can stay in the browser throughout the journey.

Mobile App

Choose Mobile App when your onboarding requires the uqudo KYC app (Mobile SDK), such as journeys that require NFC on supported documents.

This option is commonly used when you need app-based capabilities as part of the onboarding.

What you can configure

Each Hosted KYC configuration includes the following pages:

  • Workflow Settings: Define the onboarding steps, accepted documents, and optional checks.

  • Text Settings: Edit the instructions and messages shown to end-users.

  • Onboarding Settings: Control onboarding link behaviour.

  • Other Settings: Configure branding, webhook delivery, return URL, and notification email.

  • Onboard Users: Copy and share the onboarding link and add a transaction nonce when needed.

End-user journey at a glance

The user starts the onboarding directly on the mobile phone.

  • In a Mobile Browser flow, the user stays in the mobile browser.

  • In a Mobile App flow, the user continues in the mobile app.

Note: If the end-user doesn't have the uqudo KYC app in a Mobile App flow, then they will be redirected to app store to download the app and then continue the onboarding seamlessly.

The user sees a QR code and continues the onboarding on mobile after scanning it.

After completion

Once the onboarding is completed:

  • the result is sent to your webhook, if configured

  • the session is visible in the Customer Portal

  • the notification email is sent, if configured

  • the user is redirected to your return URL, if configured

Last updated

Was this helpful?