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)

1

Questionnaire

Tool: Sumsub Purpose: collect user information and assess risk profile Duration: 2 to 3 minutes

2

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

3

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.

After successful account creation and connection, users see the KYC prompt.

Account dashboard: a card showing "Verify your identity" in the pre-KYC state.

Figma reference: KYC

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).

https://docs.ur.app/developer-resources/smart-contracts#account

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.