KYC
The three-part KYC flow and how to show the URID throughout it.
Know Your Customer (KYC) verification lets your users activate their account and unlock full account functionality. The flow has three sequential parts that verify identity, collect required information, and meet regulatory requirements.
For the full account and KYC lifecycle, see The user lifecycle in the main UR docs.
Three-part KYC structure (5 to 10 minutes)
Questionnaire
Tool: Sumsub Purpose: collect user information and assess risk profile Duration: 2 to 3 minutes
Biometric ID verification
Tool: ReadID App Clip (iOS) or ReadID app (Android) Purpose: verify document authenticity via NFC chip scanning and a liveness check Duration: 2 to 3 minutes
Form A signing
Purpose: regulatory compliance and consent documentation Duration: 1 to 2 minutes
Design principles
Transparent expectations
Tell your users what is required before they start: "3 steps: answer questions, scan ID, sign form." Setting expectations reduces anxiety and abandonment.
Platform-appropriate tools
Different tools for iOS (App Clip) and Android (full app) optimize for each platform's capabilities while keeping functional parity.
Security through familiarity
Established third-party tools (Sumsub, ReadID) build on the trust your users already place in recognized verification providers.
Auto-save progress
If a user exits mid-questionnaire, they can resume without restarting.
Pre-KYC entry point
Managed Custody Mode
After a successful UR account creation, your users see the KYC prompt. If they dismiss the prompt or stop midway, they can continue KYC from an account dashboard or equivalent surface on your site.


Displaying the URID during KYC
The URID is the user's support identifier. During custom partner KYC flows, your users should always be able to read and share this value when they need support.
Where the URID comes from
Retrieve the URID by way of tokenId from the Account NFT contract by calling tokenOfOwnerByIndex(userAddress, 0).
When to display it
Keep the URID on screen for the full duration of KYC: through every step of onboarding, on each retry or failure screen, and until the user either completes KYC or exits the flow.
UX recommendations
Keep the URID always visible in a fixed area such as a top bar or sticky footer, with a one-tap way to copy it. Its visual priority should stay low so it does not compete with the primary KYC actions.
Last updated