Platform: https://proofage.net | WordPress.org: https://wordpress.org/plugins/proofage-age-verification/
A WordPress plugin for integrating with the ProofAge API — age-gate your WooCommerce store and restrict access to age-sensitive pages without handling identity documents server-side.
ProofAge is an online age verification platform enabling websites to confirm users meet minimum age requirements through a hosted, privacy-focused KYC process — without server-side document handling. It supports alcohol/tobacco/cannabis commerce, adult content platforms, gambling sites, and age-restricted subscriptions.
This plugin provides a first-class WordPress and WooCommerce integration: an admin settings page with product and category targeting, three hosted-flow launch modes (iframe modal, redirect, new tab), HMAC-signed webhook handling, and multilingual support via Polylang and WPML.
- Adds a dedicated admin settings page with a Connect ProofAge button and the gate behavior.
- Supports site-wide, category-based, and product-level protection rules.
- Protects WooCommerce product pages, add-to-cart flows, cart validation, and checkout validation.
- Stores a ProofAge verification snapshot on WooCommerce orders and shows it in the admin order details panel.
- Uses ProofAge webhooks together with browser-side return reconciliation and status polling.
- Stores only minimal verification state: status, verification ID, external ID, return URL, timestamps, expiry, and a session token.
iframe: opens the hosted ProofAge verification inside a modal iframe on the current page.redirect: opens the hosted ProofAge verification in the current browser tab.new_tab: opens the hosted ProofAge verification in a new browser tab.
- This plugin requires a ProofAge account. It connects to your workspace with a key made for this site when you click Connect ProofAge.
- It uses two hosts.
app.proofage.netis used only while connecting: the plugin sends it its public client ID, a one-time device code and a one-time token, and receives the workspace keys.api.proofage.netis the ProofAge API: it creates verifications, fetches verification status and sets up the webhook subscription through which ProofAge sends results to the site. - When a shopper starts verification, the plugin sends limited verification request data to ProofAge, such as an external identifier, callback or return URL, supported storefront language, and verification-related metadata.
- Each ProofAge API request identifies the plugin through the
X-ProofAge-Sdkheader and a User-Agent carrying the plugin, WordPress, PHP, and (when active) WooCommerce versions. - The plugin stores limited verification state locally in WordPress and WooCommerce, including verification status, verification ID, external ID, return URL, timestamps, session token, and optional order verification metadata.
- Privacy Policy: https://proofage.net/privacy
- Terms of Service: https://proofage.net/terms
- Copy the
proofage-age-verificationdirectory intowp-content/plugins/. - Activate ProofAge Age Verification in the WordPress admin.
- Open
Settings -> ProofAge Verification. - Click Connect ProofAge. The page shows a code: open the ProofAge link, sign in, enter the code, pick a workspace and click Allow. The plugin receives a key made for this site and subscribes its own webhook address (
https://your-store.example/wp-json/proofage/v1/webhook), so nothing is pasted anywhere. - Configure launch mode, gate texts, TTL, and product/category targeting rules.
Until the site is connected, protected pages stay locked and visitors see "Age verification is temporarily unavailable." The webhook address must be a public https URL; on a site ProofAge cannot reach, the plugin checks results when the shopper comes back instead.
The plugin appends an origin query parameter automatically for each verification attempt so the shopper can be returned to the correct page after the hosted flow finishes.
- Product and category overrides are available only when WooCommerce is active.
- For guests, verification state is tracked with a signed browser cookie plus a server-side transient.
- For authenticated users, verification also persists to user meta, but access still requires the current browser session token.
- The connectivity test in the settings page uses the
GET /v1/consentProofAge endpoint. - When Polylang or WPML String Translation is active, the Gate texts fields act as source strings and can be translated through the multilingual plugin UI.
- Verification creation passes the current storefront language to ProofAge when it matches a supported ProofAge SDK language.
proofage-age-verification.phpboots the plugin.src/Plugin.phpwires all modules together.src/ProofAge/ApiClient.phphandles outbound ProofAge API requests.src/Verification/RulesEngine.phpresolves global, category, product, and exclusion precedence.src/Verification/StateRepository.phpstores cookie, transient, and user-meta state.src/Http/RestRoutes.phpexposes the session, status, and webhook endpoints.
- Frontend JavaScript calls
POST /wp-json/proofage/v1/session. - The plugin creates a ProofAge verification and stores a pending local session.
- The shopper completes the hosted flow via iframe modal, redirect, or a new tab.
- ProofAge sends a webhook to
/wp-json/proofage/v1/webhook. - The browser returns to
/?proofage-return=1, where the plugin reconciles transient state and updates the local session when a terminal decision is available.
- Site-wide page gating.
- WooCommerce single product gating.
- Loop add-to-cart interception.
- Server-side add-to-cart validation.
- Cart validation.
- Checkout validation.
- Store API add-to-cart validation for block-based flows.
The current implementation includes focused Pest tests for:
- launch-mode sanitization
- rule precedence
- ProofAge request signing
- webhook signature verification
- approval/session binding
- authenticated session confirmation rules
- Platform: https://proofage.net
- Live Demo: https://demo.proofage.net
- Node SDK:
@proofage/nodeon npm
| Platform | Repository | Use-case |
|---|---|---|
| Node.js | ProofAge/node-client | Node.js age verification client — HMAC-signed API calls, webhook verification for Express, Hono, Next.js and other Node.js frameworks |
| WordPress | this repo | Age gate plugin for WordPress — WooCommerce age verification, age-restricted pages, adult content gating |
| Laravel | ProofAge/laravel-client | Laravel age verification client — HMAC-signed API calls, webhook handling, middleware for age-restricted routes |
| Next.js | ProofAge/demo | Full-stack age verification demo with JS SDK, server routes, and webhook receiver |
The MIT License (MIT). Please see License File for more information.