🏠 Overview › 🧩 Components ›🧩 Deep Link Handler

Deep Link Handler

Component Detail

Infrastructure medium complexity Shared Component mobile
0
Dependencies
1
Dependents
1
Entities
1
Integrations

Description

Processes incoming deep links containing referral tokens when a new member taps the referral URL. Extracts the referral code, routes the app to the onboarding screen, and passes the token for attribution recording.

Feature: Membership Recruitment (Verving)

deep-link-handler

Responsibilities

  • Intercept incoming deep links at app startup and foreground resume
  • Parse referral code from URI query parameters
  • Route to new member onboarding screen with extracted token
  • Handle malformed or expired referral link gracefully

Interfaces

handleIncomingLink(uri)
extractReferralCode(uri)
routeToOnboarding(code)
onInvalidLink(uri)
registerLinkListener()

Relationships

Dependents (1)

Components that depend on this component

ui New Member Onboarding Screen

Related Data Entities (1)

Data entities managed by this component

Referral Code 11 fields core

Used Integrations (1)

External integrations and APIs this component relies on

Vipps Login API API

API Contract

View full contract →
REST /api/v1/deep-links 4 endpoints
GET /api/v1/deep-links List recorded incoming deep links
POST /api/v1/deep-links/parse Parse an OAuth callback URI into structured fields
GET /api/v1/deep-links/initial Get the initial deep link that launched the app
POST /api/v1/deep-links/initialize Initialize deep link listener for the session