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
Create a Hosted KYC configuration in the Customer Portal.
Choose how end-users will complete onboarding:
Mobile Browser
Mobile App
Configure the workflow, text, branding, onboarding settings, and delivery settings.
Share the generated onboarding link with your end-users.
The end-user completes the onboarding journey on a mobile phone.
uqudo sends the result to your configured webhook, makes the session available in the Customer Portal, and can also send a notification email.
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
Open the Customer Portal.
Go to Hosted KYC.
Click Create Configuration.
Choose one of the available onboarding channels:
Mobile Browser
Mobile App
Enter a clear configuration name.
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
If the link is opened on mobile
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.
If the link is opened on desktop
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?