Testing Your Setup

This guide walks you through verifying that each VerifyHuman feature is correctly installed and working on your Shopify store.

Prerequisites

Before testing, ensure:

1. The VerifyHuman app is installed and active on your store.
2. Your VerifyHuman API key is entered in Settings > API Configuration.
3. The verifyhuman.app_url metafield is set (check via Settings > Diagnostics).
4. At least one verification feature is enabled in Settings.
5. The Theme App Extension is enabled in your theme editor.

Step 1: Run Diagnostics

The built-in diagnostics tool checks your entire setup automatically.

1. Open the VerifyHuman app in your Shopify admin.
2. Go to Settings.
3. Scroll to the Diagnostics card.
4. Review each check:

If the metafield check fails or shows a warning, click the Repair button to automatically fix it.

Step 2: Test Age Gate

Enable Age Gate

1. In the VerifyHuman dashboard, go to Settings > Age Gate tab.
2. Toggle Age Verification on.
3. Set your preferred minimum age, use case, and trigger mode.
4. Click Save Changes.

Verify in Theme Editor

1. Go to Online Store > Themes > Customize.
2. Click App embeds in the left sidebar.
3. Confirm VerifyHuman - Age Gate is toggled on.
4. Check the settings match your preferences (trigger mode, minimum age, etc.).

Test on Storefront

1. Open your store in a new incognito/private browser window.
2. Navigate to a page where the age gate should appear:
   • If trigger mode is Entire Store: any page should show it.
   • If trigger mode is Product Tag: visit a product tagged with your configured tag (default: age-restricted).
   • If trigger mode is Collection Tag: visit a collection with the configured tag.
   • If trigger mode is Specific Pages: visit one of the page handles you configured.
3. The age verification overlay should appear and block page content.
4. Test both flows:
   • Click Yes / I am of age to proceed (with selfie if Require Selfie is enabled).
   • Click No / I am underage to be redirected to the configured URL (default: google.com).
5. After passing verification, refresh the page. The overlay should not reappear until the session expires.

Verify Session Duration

• Verification is remembered for the configured session duration (default: 24 hours).
• Clear your browser cookies or wait for the session to expire, then revisit to confirm the overlay reappears.

Step 3: Test Identity Verification

Button-Triggered (App Block)

1. Go to Online Store > Themes > Customize.
2. Navigate to the page where you want the verification button (e.g., a product page).
3. Click + Add block in the relevant section.
4. Select Identity Verification under Apps.
5. Configure the button text, color, and optional redirect URL.
6. Save the theme.

Test:

1. Visit the page on your storefront.
2. Click the Verify My Identity button.
3. The identity verification modal should appear requesting an ID document photo and a selfie.
4. Complete the flow and verify the success callback fires (check browser console for [VerifyHuman] Identity verified: log).

Checkout Guard (App Embed)

1. In the theme editor, go to App embeds.
2. Enable VerifyHuman - Checkout ID.
3. Configure when verification is required:
   • All Checkouts: every checkout triggers verification.
   • Product Tag: only products tagged with vh_requires_idv (or your custom tag).
   • Product Metafield: products with verifyhuman.requires_idv set to true.

Test:

1. Add a product with the required tag or metafield to your cart.
2. Go to the cart page.
3. The checkout button should be replaced or blocked with a verification prompt.
4. Express checkout buttons (Shop Pay, Apple Pay, Google Pay) should be hidden if Hide Express Checkout Buttons is enabled.
5. Complete identity verification and confirm checkout becomes available.
6. If Show Verified Badge is enabled, a green checkmark should appear near the checkout button.

Step 4: Test Human Check (Bot Protection)

Enable Human Check

1. In the VerifyHuman dashboard, go to Settings > Human Check tab.
2. Toggle Human Verification on.
3. Enable the form types you want to protect:
   • Signup/Registration Forms
   • Review Forms
   • Contact Forms
   • All Forms (site-wide)

Verify in Theme Editor

1. Go to Online Store > Themes > Customize.
2. Click App embeds.
3. Confirm VerifyHuman - Human Check is toggled on.
4. Review which form types are enabled and any custom selectors.

Test on Storefront

1. Navigate to a page with a protected form (e.g., your contact page, registration page, or a product review form).
2. Try to submit the form without verification.
3. The form should be intercepted and a selfie verification prompt should appear.
4. After passing verification, a Verified badge should appear (if Show Badge is enabled).
5. Submit the form again; it should go through successfully.

Debug Mode

If forms are not being detected:

1. In the theme editor, enable Debug Mode in the Human Check settings.
2. Open your browser developer console (F12 or Cmd+Opt+I).
3. Look for [VerifyHuman] log messages showing which forms were detected and which selectors matched.
4. If your theme uses non-standard form IDs, configure custom selectors in the Advanced: Custom Form Selectors section.

Step 5: Verify API Connectivity

1. In the VerifyHuman dashboard, go to Settings.
2. Check the Usage section to confirm the app can communicate with the VerifyHuman API.
3. Expected statuses:
   • PASS: API is reachable and your key is valid.
   • NO_API_KEY: You need to add your API key in Settings.
   • API_ERROR: The API returned an error; check your key or contact support.

Step 6: Check Logs

After running through the test flows above:

1. Go to the Logs page in the VerifyHuman dashboard.
2. Verify that events were recorded:
   • verification_started for each verification attempt.
   • verification_completed or verification_failed for the result.
   • settings_updated when you changed settings.
3. Filter by severity to find any errors.

Step 7: Test Across Devices

• Test on desktop browsers (Chrome, Firefox, Safari).
• Test on mobile browsers (iOS Safari, Android Chrome).
• Ensure the camera prompt appears correctly for selfie-based verifications.
• Verify the age gate overlay is responsive and covers the full screen on mobile.

Quick Checklist