WordPress & WooCommerce

​

Prerequisites

• WordPress 6.0 or higher
• PHP 7.4 or higher
• A Didit Console account

​

Step 1: Get your Didit credentials

1. Sign up or log in at business.didit.me
2. Go to API & Webhooks and copy your API Key
3. Go to Workflows, create or select a workflow, and copy the Workflow ID

​

Step 2: Install the plugin

1. Download didit-verify.zip from the latest release
2. In your WordPress admin, go to Plugins → Add New → Upload Plugin
3. Choose the downloaded ZIP file and click Install Now
4. Click Activate

​

Step 3: Configure the plugin

​

Choose your mode

​

Configure session options (API mode only)

• Vendor Data — Links each verification to a specific user in your Didit dashboard, so you can track who verified. Default is WordPress User ID (e.g. wp-42). You can also choose User Email, a custom prefix, or disable it.
• Callback URL — A page on your site where users are redirected after verification. Didit appends verificationSessionId and status as query parameters.
• Callback Method — Which device handles the redirect: initiator (the device that started), completer (the device that finishes), or both.
• Language — Choose from 49 languages or let it auto-detect from the browser.

​

Configure display options

• Display Mode — Modal (popup overlay) or Embedded (inline on the page)
• Close Button — Show or hide the X button on the modal
• Exit Confirmation — Show an “Are you sure?” dialog when closing
• Auto-close — Automatically close the modal when verification completes
• Debug Logging — Log SDK events to the browser console (for troubleshooting)

​

Customize the button

• Button text and success text
• Background color and text color
• Border radius, padding, and font size

​

Step 4: Add verification to your site

​

For WooCommerce stores

1. In Settings → Didit Verify → WooCommerce, check Require identity verification at checkout
2. Choose where the verification section appears:
   • Top of checkout page
   • After billing details
   • After order notes
   • Before “Place Order” (recommended)
3. Optionally enable Send Billing Data to auto-send the customer’s name, email, phone, and address to Didit for pre-filling and cross-validation

​

For any WordPress page

[didit_verify]

[didit_verify text="Verify Now" success_text="Done!"]

[didit_verify mode="embedded"]

​

Step 5: Restrict content to verified users (optional)

[didit_gate]
This content is only visible to verified users.
[/didit_gate]

[didit_gate message="Please verify to continue."]Secret content here.[/didit_gate]

[didit_status]

​

Checking verification status

​

Troubleshooting

​

Security

1. CSRF nonce — requests must originate from your WordPress site
2. Login requirement — only registered users can create sessions (configurable)
3. Rate limiting — 10 sessions/hour per user, 3/hour per IP for guests
4. Input sanitization — all fields are whitelisted and sanitized server-side

​

For developers

​

PHP hooks

// When a user completes verification
add_action('didit_verification_completed', function ($user_id, $session_id, $status) {
    // Update CRM, send email, grant access, etc.
}, 10, 3);

// When a user cancels verification
add_action('didit_verification_cancelled', function ($user_id, $session_id) {
    // Log cancellation
}, 10, 2);

// When a session is created server-side
add_action('didit_session_created', function ($url, $user_id, $vendor_data) {
    // Log, notify, etc.
}, 10, 3);

​

JavaScript event

document.addEventListener('didit:complete', function (e) {
    console.log('Result:', e.detail); // { type, session }
});

​

Check verification in PHP

$is_verified = get_user_meta($user_id, '_didit_verified', true); // returns 1 if verified

​

Resources

• Plugin source code (GitHub)
• Didit API documentation
• Didit Console
• Create Session API reference