feat(idenfy): apply Human ID KYC branding theme to token sessions#51
Merged
Conversation
Pass our iDenfy KYC branding theme UUID as `theme` on /api/v2/token so the hosted verification UI matches Human ID branding instead of iDenfy's stock look. Both the gov-id and clean-hands flows go through createIdenfyToken, so this covers both. iDenfy falls back to its "Default" theme when `theme` is omitted; this overrides that. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Pass our iDenfy KYC branding theme UUID as the
themeparameter onPOST /api/v2/tokenso the hosted iDenfy verification UI renders with Human ID branding (colors + logo) instead of iDenfy's stock look.Why
We recently shipped iDenfy in the gov-id and clean-hands flows, but the verify page still showed iDenfy's default branding. iDenfy's documented per-session override is the
themefield (UUID from the dashboard Branding section); when omitted, iDenfy falls back to its built-in "Default" theme.How
IDENFY_KYC_THEME_UUIDinsrc/services/idenfy/token.ts.themetoCreateIdenfyTokenRequest(replaces the oldTODOnote about optional fields).theme: IDENFY_KYC_THEME_UUIDin the token request body.Both the gov-id and clean-hands flows funnel through
createIdenfyToken, so this single change covers both. No frontend changes needed — the theme is baked into the session server-side at token mint time.Notes / reviewer attention
themeis sent on both live and sandbox token calls (thesandboxflag only switches API credentials, not the body). iDenfy themes are per-account, so this UUID must exist in both the live and sandbox iDenfy dashboards. If we want live-only, it's a one-line gate on the existingsandboxarg.Test plan
🤖 Generated with Claude Code