Skip to main content

Product configuration

This guide covers creating and configuring products in the Compliance Studio for age verification.

Product test and live modes

Each product in the Compliance Studio has two distinct modes:

  • Test Mode: For development and testing
  • Live Mode: For production use

Key differences

AspectTest ModeLive Mode
API Hostnametest.prod.ageapi.orgprod.ageapi.org
Product ConfigurationSeparate test settingsSeparate live settings
API KeysTest-specific keysLive-specific keys
WebhooksTest webhook endpointsLive webhook endpoints
UsageDevelopment and testingProduction traffic

Important - Start with test mode for development. You only need to create a live mode product when you're ready to launch to production. In test mode you can use provider test credentials (for example, test cards and test IDs) to simulate outcomes; it can't produce real, verified results for real users. For details, see Testing and development considerations.

Creating a new product

Screenshot Placeholder

  1. In the dashboard, click "New Product"

    • Navigate to the main dashboard
    • Look for the "New Product" button
  2. Choose creation method

    • A dialog is displayed asking to create a new product or use an existing one as a template
    • Select your preferred option
  3. Click "Create" in the dialog

    • Confirm your selection to proceed
  4. Product is created

    • If not using a template, the product name is set to "Untitled"
    • You can rename it later in the product settings
  5. Set product details and push to test

    • Set the product name and description
    • Click "Push to Test" in the top right corner to activate the product

Configuring your product

Basic settings

After creating your product, you can configure:

  • Product name and description
  • Verification methods (age estimation, ID document)
  • Age thresholds for different categories
  • Jurisdiction settings for compliance

Customizing verification methods

Screenshot Placeholder

To configure age assurance and verification methods:

  1. Select product from dashboard

    • Choose your product from the main dashboard
  2. Click "Assurance & Verification"

    • Navigate to the assurance and verification section
  3. Click the edit button on the right side of "OpenAge"

    • This opens the OpenAge configuration options

OpenAge settings

You can customize the following settings:

Skip user method selection on single option (toggle)

  • When enabled, skips method selection for the user when there is only one available option

OpenAge (toggle)

  • Do you want to configure verification methods?
  • After enabling, users can select verification methods used globally, or they can set verification methods that are jurisdiction specific

Available verification methods

Configure which verification methods are available for your product, including region specific verification methods. For detailed information about each verification method, see the Verification Methods Guide.

Default Verification Methods

By default, a product has AgeKey, ID scan verification, and facial age estimation scan enabled. For users in Australia, ConnectID is also enabled by default. Other verification methods can incur additional costs. To enable additional methods, contact your OpenAge representative.

Enabling, disabling, and Fallback only

Under the Assurance and Verification tab, each verification method your product lists there can be set to one of three states:

  • Enabled: The method can be shown to users according to the usual rules (for example, based on jurisdiction).
  • Disabled: The method is never shown.
  • Fallback only: The method is shown only after the user has attempted another verification method and that attempt didn't produce an age signal (it ended without determining whether the user meets your age criteria). Use this when you want a backup method available only when a prior attempt failed to reach a conclusive verification outcome.

These states apply per-method and are respected by both global and jurisdiction-specific verification lists.

Ordering verification methods

You can control the order in which verification methods are presented to end users for a given jurisdiction (or globally). Under the Assurance and Verification tab, each Enabled method has a drag handle at the left of each row that you can use to change its position in the list. Disabled methods can't be dragged. Fallback only methods are ordered among themselves and are only considered after a non-fallback attempt fails to produce an age signal.

To change the order:

  1. Open the Assurance and Verification tab for your product.
  2. Select the scope you want to reorder (global, or a specific jurisdiction).
  3. Drag an Enabled method to its new position. A shadow row indicates the drop target.
  4. Release to drop. The new order is saved automatically.
  5. To go back to the system default, click Reset to default order preceding the list.

Order precedence for end users

When the OpenAge verification widget picks which methods to offer, it resolves order in this priority:

  1. Exact jurisdiction configuration (for example, US-CA).
  2. Parent jurisdiction configuration (for example, US).
  3. Global product configuration.
  4. OpenAge default order.

The same precedence applies to which methods are Enabled, Disabled, or Fallback only.

Next steps