-
Select your store (if you have multiple stores)
-
Click Install to add the app to your store
After installation, you’ll be redirected to the Didit Verify Preferences page. Here you’ll connect the app to your Didit account.
Get Your API Key
- Log in to the Didit Business Console
- Navigate to Settings → API & Webhooks
- Copy your API key
- Paste the API key into the Didit API Key field in the Shopify preferences
Get Your Workflow ID
- In the Didit Business Console, go to Workflows
- Select the workflow you want to use (or create a new one)
- Copy the Workflow ID (a UUID like
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)
- Paste the Workflow ID into the Didit Workflow ID field
Save Your Settings
Click Save Settings. You should see a success message:
- In your Shopify admin, go to Online Store → Themes
- Click Customize on your active theme
- Navigate to the page where you want the verification button (e.g., Account page, a custom page)
- Click Add section or Add block
- Go to the Apps tab
- Select Didit Verify
The verification button will appear in your theme. You can drag it to reposition it within the section.
Configuration Options
Preferences Page Settings
These settings are configured in the app preferences (accessible from Apps → Didit Verify in your Shopify admin):
| Setting | Description |
|---|
| API Key | Your Didit API key (required) |
| Workflow ID | The verification workflow to use (required) |
| Vendor Data Mode | How to identify users in your Didit dashboard: by customer ID, email, or shop+customer |
| Callback URL | Optional webhook URL to receive verification results |
| Language | Verification UI language (auto-detect or specific language) |
| Require Customer Login | If enabled, only logged-in customers can verify |
| Auto-send Customer Data | Prefill verification with customer’s name, email, and address |
Theme Block Settings
These settings are configured in the Shopify theme editor when you select the Didit Verify block:
Connection
| Setting | Description |
|---|
| Mode | API Session (recommended) — creates unique sessions per user. UniLink — uses a fixed verification URL (no backend needed). |
| UniLink URL | Only used in UniLink mode. Paste your UniLink URL from the Didit Console. |
Display
| Setting | Description |
|---|
| Display Mode | Modal — opens verification in a popup overlay. Embedded — shows verification inline below the button. |
| Show close button | Show/hide the X button to close the verification modal |
| Exit confirmation dialog | Ask users to confirm before closing verification |
| Auto-close on completion | Automatically close the modal when verification completes |
| Debug logging | Enable browser console logs for troubleshooting |
| Setting | Description |
|---|
| Button text | Text shown on the button (default: “Verify your Identity”) |
| Success text | Text shown after successful verification (default: “Identity Verified ✓“) |
| Background color | Button background color |
| Text color | Button text color |
| Border radius | Button corner roundness (0–50px) |
| Vertical padding | Top/bottom padding (0–40px) |
| Horizontal padding | Left/right padding (0–60px) |
| Font size | Button text size (10–32px) |
Recommended Setup
For most stores, we recommend:
- Mode: API Session (creates unique verification sessions, better tracking)
- Display Mode: Modal (works everywhere, no layout issues)
- Require Customer Login: Enabled (links verification to customer accounts)
- Auto-send Customer Data: Enabled (prefills customer info, faster verification)
Testing
- Preview your theme or visit your store
- Navigate to the page with the Didit Verify button
- Click Verify your Identity
- Complete the verification flow
- Check your Didit Business Console to see the verification result
New Didit accounts receive $10 in free credits for testing. Each verification uses a small amount of credits.
Troubleshooting
- Make sure you’ve saved your API Key and Workflow ID in the preferences
- Check that the Workflow ID belongs to the same application as your API Key
- Enable Debug logging in the block settings and check the browser console for errors
Support (24/7)
Our team is available to help you get up and running.
