Embed Widget Configuration

The verification widget runs inside an iframe on your page. Configure it with URL parameters to match your platform's requirements.

Iframe URL Format

The embed URL follows this pattern:

https://ageevidence.com/embed/{level}?apiKey={key}&externalId={id}&theme={theme}&locale={locale}&parentOrigin={origin}

Replace {level} with one of the verification levels listed below.

Parameters

Parameter	Required	Description
`apiKey`	Yes	Your publishable API key (`pk_verify_...`). Safe for browser use.
`externalId`	Yes	Your platform's unique user identifier. Used to track verification status.
`theme`	No	`light`, `dark`, or `auto`. Default: `dark`.
`locale`	No	`en`, `es`, `pt`, or `fr`. Default: `en`.
`parentOrigin`	No	Your site's origin (e.g. `https://yoursite.com`) for postMessage security filtering. Recommended.

Verification Levels

Choose the level that matches your compliance and business requirements:

Level	Path	Description
`age_only`	`/embed/age_only`	Quick 18+ check via face estimation. No ID document required. Can auto-approve for clearly adult faces.
`full_age`	`/embed/full_age`	Strong age verification with ID document + liveness + face matching. Admin review required.
`full_kyc`	`/embed/full_kyc`	Full identity verification. Same flow as full_age, plus 2257 performer record creation on approval.

Dimensions and Camera

Recommended dimensions: width 100%, height 600px. The widget is responsive and adapts to the container width.

The allow="camera" attribute is required on the iframe element. Without it, the browser will block camera access inside the widget and the verification flow cannot proceed.

<iframe
  src="https://ageevidence.com/embed/full_age?apiKey=pk_verify_YOUR_KEY&externalId=user_123"
  width="100%"
  height="600px"
  frameborder="0"
  allow="camera"
  style="border: none; border-radius: 12px;"
></iframe>

Theming

The widget supports three theme modes:

dark -- Dark background with light text. Best for dark-themed platforms. This is the default.
light -- Light background with dark text. Best for light-themed platforms.
auto -- Follows the user's system preference via prefers-color-scheme.

Pass the theme as a URL parameter: theme=dark, theme=light, or theme=auto.