WooCommerce Integration

When WooCommerce is installed, the AgeOnce plugin automatically protects checkout for products that require age verification.

How it works

1. You mark products that require verification (see below)
2. When such a product is in the cart, the checkout page shows the verification gate
3. User must complete AgeOnce verification before placing the order
4. After successful verification, the order can be completed
5. The order stores verification status, Transaction ID, and verification time

Marking products for verification

Method 1: Per-product checkbox

1. Edit the product in WooCommerce
2. In Product Data → General, find Age Verification Required
3. Check the box
4. Save

Method 2: Product categories (Content Rules)

1. Go to AgeOnce → Content Rules
2. Enable Products
3. Select Active Age Groups (e.g. 18+)
4. In 18+ Rules, select Product Categories (e.g. Alcohol, Tobacco)
5. All products in those categories will require verification

Method 3: Both

Products can be restricted by category and/or individually. The highest required age applies.

Checkout behavior

Before verification

When the cart contains age-restricted products:

• Verification gate appears above the Place Order button
• "Verify Age" button redirects to AgeOnce
• Checkout is blocked until verification is completed

After verification

• Success message: "Age verified. You can proceed."
• User can place the order
• Result is stored in session — no need to verify again for subsequent orders in the same session

Callback URL

The plugin uses this Redirect URI for checkout verification:

https://yoursite.com/?ageonce_callback=1

Add it to Dashboard Settings → Redirect URIs. The plugin shows the exact URL to copy in AgeOnce → Settings.

Transaction ID and audit

After a successful verification at checkout, the plugin saves the Transaction ID (Audit ID) to the order as order meta. In the WordPress admin:

• Open the order and check the AgeOnce metabox in the sidebar
• You will see Tx ID and Verified At for verified orders

You can store this Transaction ID (e.g. in your order or CRM) and later look up the verification in the Dashboard Audit Logs: search by this ID to see when and how the verification was completed. This helps with compliance and support.

Recommended first test

1. Create a test product category such as Alcohol or 21+
2. Assign one test product to that category
3. Enable Products in AgeOnce → Content Rules
4. Select the test category under the right age threshold
5. Open checkout in an incognito browser window
6. Complete AgeOnce verification and confirm the order stores the verification metadata

Compatibility

Tested with WooCommerce 5.0+ and common themes (Storefront, Astra, etc.). If you use custom checkout or checkout-modifying plugins, test on a staging site first.