Shopify

The Incode Age Verification for Shopify integration adds identity-based age verification to your Shopify checkout. When a customer attempts to purchase an age-restricted product, they are redirected to complete an Incode identity verification flow before their order can be placed.

📘
Note
This integration requires Shopify Plus. Checkout UI extensions are a Shopify Plus feature.

How it works

Merchant tags age-restricted products with age-restricted in Shopify Admin
When a customer adds one of these products to their cart, the app detects it
At checkout, a banner appears: "Identity Verification Required"
The customer clicks "Verify with Incode" and completes the identity flow on their device
On success, they are returned to checkout and can complete their purchase
On failure, they are shown an error and cannot proceed
All verification results (session ID, pass/fail, timestamp) are stored as order attributes for merchant audit

Prerequisites

Shopify Plus store
Incode account with API access
Your Incode API Key (from Incode Dashboard → Settings → API Keys)
Your Incode Flow ID (the onboarding flow configured for age verification)
The Incode Age Verify app installed on your store

Setup Guide

Step 1: Install the app

Your Incode account manager will provide you with an installation link. Click it and follow the Shopify OAuth prompts to install Incode Age Verify on your store.

Step 2: Configure your Incode credentials

In your Shopify Admin, go to Apps → Incode Age Verify
On the settings page, enter:
- API Key: your Incode API key
- Flow ID: the Incode onboarding flow ID for age verification
- Backend URL: provided by your Incode account manager (leave blank if unsure)
Click Save Settings
The Connection Status badge should turn green: ✓ Connected

Step 3: Enable the theme script

This script detects age-restricted products and sets up cart attributes before checkout.

Go to Online Store → Themes → Customize
In the left panel, click App embeds (puzzle piece icon)
Toggle "Incode Age Verify" to ON
In the Backend URL field that appears, enter the same backend URL from Step 2
Click Save

Step 4: Tag your age-restricted products

Go to Products in your Shopify Admin
Open each age-restricted product
In the Tags field, add the tag: age-restricted
Save the product

⚠️
Warning
The tag must be exactly age-restricted (lowercase, hyphenated). Any product with this tag will trigger the verification flow at checkout.

Step 5: Verify the checkout extension is active

Go to Settings → Checkout → Customize
Click the Apps section
Confirm "Incode Age Verify" is listed and active

Testing the integration

Add an age-restricted tagged product to your cart
Proceed to checkout
You should see the "Identity Verification Required" banner above the payment section
Click "Verify with Incode". You'll be redirected to Incode's verification flow
Complete the verification on your mobile device
You'll be returned to checkout with a "Identity verified with Incode — you're all set!" confirmation
Complete the purchase as normal

Viewing verification records

Every order placed through the verification flow includes the following in the Additional details section of the order in Shopify Admin:

Attribute	Description
`age_verification_required`	Whether verification was required (`true`/`false`)
`age_verified`	Whether the customer passed verification (`true`/`false`)
`age_verified_status`	`pass` or `fail`
`age_verified_session`	Incode session reference ID (first 16 chars of token)
`age_verified_at`	ISO timestamp of when verification occurred
`age_verified_by`	Always `incode`

To view: open any order in Shopify Admin → scroll to Additional details.

Troubleshooting

Verification banner doesn't appear at checkout

Confirm the product has the age-restricted tag (exact spelling)
Confirm the theme app extension is enabled (Step 3)
Try clearing your cart and re-adding the product — the cart attribute sync happens on page load
Confirm the app is installed: Apps → Incode Age Verify should load the settings page

"Verify with Incode" button does nothing

The Backend URL in the theme editor may be incorrect or the backend may be unreachable
Contact your Incode account manager to confirm the backend URL

Verification completes but checkout still shows the banner

Clear your browser cache and reload the checkout page
Ensure you are returning to the correct store URL after verification

"Identity Verification Failed" message

The customer did not pass the identity check
They can click "Try Again" to retry
Age-restricted items must be removed from the cart if they choose not to verify

Support

For setup assistance or issues, contact your Incode account manager or reach out to [email protected].