Zoho People Extension
Help & Troubleshooting
Common issues, error messages, and step-by-step fixes for the VeridionQ BGV extension for Zoho People.
Jump to a Section
Troubleshooting
"API key required" error when opening a widget
Likely Cause
The API key has not been saved in the extension settings.
Fix
"API access not enabled" error
Likely Cause
API access is disabled for your VeridionQ account.
Fix
"Insufficient credits" when initiating BGV
Likely Cause
Your VeridionQ credit balance is zero.
Fix
BGV status not updating in Zoho People
Likely Cause
Zoho OAuth token has expired or been revoked.
Fix
BGV status not updating — Zoho OAuth is connected
Likely Cause
The P_bgvTracking custom form is missing or fields have incorrect API names.
Fix
Sync log shows FAILED entries
Likely Cause
Network timeout, Zoho rate limit, or token expiry at time of sync.
Fix
Widget shows blank / loading indefinitely
Likely Cause
Browser is blocking third-party cookies or Zoho SDK failed to load.
Fix
Bulk initiation shows some employees as Skipped
Likely Cause
These employees were already submitted in the same batch within the past 24 hours.
Fix
Reconnecting Zoho OAuth
Zoho OAuth tokens expire periodically. When they do, BGV status updates stop syncing to Zoho People. Follow these steps to reconnect:
- 1
Open Zoho People as an admin.
- 2
Go to Settings → Extensions → VeridionQ BGV → Open.
- 3
The Settings widget will show 'Zoho People: Disconnected'.
- 4
Click Connect Zoho People.
- 5
Complete the Zoho authorisation in the popup.
- 6
The widget shows 'Zoho People: Connected'. Sync resumes automatically.
Frequently Asked Questions
Does VeridionQ store my employees' data inside Zoho People?
No. VeridionQ stores only the minimum reference data needed to link a Zoho People employee record to a VeridionQ case — specifically the Zoho employee ID. All BGV data (documents, verification results) stays in VeridionQ's secure platform.
What Zoho People plan is required?
Professional or above. The extension uses Zoho People's API and custom forms features, which are available from the Professional plan onwards.
Can I use the extension in a Zoho People sandbox?
Yes. When configuring the extension, select 'Sandbox' as the environment. This connects to VeridionQ's sandbox where BGV cases are simulated without real verifications or credit deductions.
How long does it take for BGV status to appear in Zoho People?
Status updates are pushed to Zoho People automatically within seconds of a status change in VeridionQ. If an update fails, it is retried automatically. You can also trigger a manual retry from the sync logs.
Who can initiate a BGV — all Zoho People users or only admins?
Any Zoho People user with access to the employee record can initiate a BGV using the extension widget, provided your organisation has active VeridionQ credits. The Settings and sync log pages are restricted to Zoho admins.
Can I use one VeridionQ account for multiple Zoho People organisations?
No. Each Zoho People organisation is connected to exactly one VeridionQ account. If you manage multiple Zoho orgs, you need a separate VeridionQ account for each.
What happens if I uninstall the extension?
Uninstalling removes the widgets from Zoho People. Your VeridionQ cases and BGV records are not deleted — they remain accessible in your VeridionQ portal. The Zoho OAuth connection is automatically revoked.
Is the data transfer between Zoho People and VeridionQ encrypted?
Yes. All communication uses HTTPS/TLS. API keys are stored encrypted inside Zoho People's extension configuration store. Zoho OAuth tokens are encrypted at rest using AES-256 in the VeridionQ backend.
Still need help?
Our support team typically responds within one business day. Include your VeridionQ account email and a description of the issue.