Prerequisites
- WordPress 6.0 or later
- PHP 8.1 or later
- WooCommerce 8.0+ (for checkout verification)
- Verilock Business or Enterprise plan
Installation
Install the Plugin
Download the plugin from the Verilock dashboard or search for Verilock Identity in the WordPress plugin directory.
Configure API Credentials
In WordPress admin, navigate to Settings > Verilock and enter:
- API Key: Your Verilock API key
- Webhook Secret: Your webhook signing secret
Configure Webhook Endpoint
The plugin automatically registers a webhook endpoint at:Copy this URL and add it as a webhook endpoint in your Verilock dashboard.
Verification Triggers
- Registration
- WooCommerce Checkout
- Shortcode
When enabled, new users are redirected to the Verilock hosted verification flow after registration. Their account remains in a
pending_verification state until approved.| Setting | Description | Default |
|---|---|---|
require_verification | Block access until verified | true |
verification_profile | Profile to use (basic/standard/enhanced) | standard |
redirect_after | URL to redirect to after verification | Account page |
Hosted Flow Embedding
The plugin embeds the Verilock hosted verification flow using either a modal overlay or a full-page redirect:| Mode | Description |
|---|---|
| Modal | Overlay on the current page. Recommended for checkout flows. |
| Redirect | Full-page redirect to Verilock. Recommended for registration. |
User Meta Fields
After verification, the plugin stores the result in WordPress user meta:| Meta Key | Value |
|---|---|
verilock_status | approved, declined, pending, expired |
verilock_session_id | Session ID (e.g., ses_a1b2c3d4e5f6) |
verilock_verified_at | ISO 8601 timestamp |
verilock_risk_score | Numeric risk score (0-100) |
Use these meta fields to conditionally display content or restrict access using WordPress role/capability checks or third-party membership plugins.
Webhook Processing
The plugin automatically processes the following webhook events:| Event | Plugin Action |
|---|---|
session.approved | Set user status to approved, grant verified role |
session.declined | Set user status to declined, send notification email |
session.expired | Set user status to expired, prompt re-verification |
Troubleshooting
Webhook not received
Webhook not received
Verify the webhook URL is reachable from the internet. Check that no security plugin (Wordfence, Sucuri) is blocking the
/wp-json/verilock/v1/webhook endpoint. Allowlist Verilock IPs if necessary.Modal not loading
Modal not loading
Ensure no JavaScript errors exist on the page. The plugin requires jQuery (bundled with WordPress). Check for conflicts with your theme or other plugins.
WooCommerce checkout not triggering
WooCommerce checkout not triggering
Verify the product categories are correctly mapped in Settings > Verilock > WooCommerce. Check that the order total meets the configured threshold.

