🎯 KYC as Separate Widget
Onmeta provides a standalone KYC widget that merchants can use for independent KYC verification purposes. This widget can be accessed via a dedicated URL.
Use Case
- Merchants using our API integration can use this OnMeta’s KYC widget to let OnMeta handle the complete KYC process
Basic Implementation
Staging Environment
For testing and development, use the staging URL:
https://stg.platform.onmeta.in/kyc/?apiKey=<your_apikey>
Example:
https://stg.platform.onmeta.in/kyc/?apiKey=8794c88xxxxxxxxxxx
Production Environment
For live production environment:
https://platform.onmeta.in/kyc/?apiKey=<your_apikey>
Example:
https://platform.onmeta.in/kyc/?apiKey=f1f853bxxxxxxxxxx
Self-Explanatory Widget
The KYC widget provides clear on-screen instructions at each step. Users can easily complete the verification process by following the guided workflow.
Advanced Configuration
Skip Login with User Email
You can bypass the login step by passing the user's email directly in the URL:
https://stg.platform.onmeta.in/kyc/?apiKey=<your_apikey>&userEmail=<user_email>
Example:
https://stg.platform.onmeta.in/kyc/?apiKey=8794c88xxxx&userEmail=john@example.com
✅ With Email
User skips login/OTP and goes directly to KYC verification
📧 Without Email
User must login with email and OTP before starting KYC
Custom Redirect URLs
Configure success and failure redirect URLs to return users to your application after KYC completion:
https://stg.platform.onmeta.in/kyc/?apiKey=<your_apikey>&userEmail=<user_email>&successRedirectUrl=<your_success_url>&failureRedirectUrl=<your_failure_url>
Complete Example:
https://stg.platform.onmeta.in/kyc/
?apiKey=8794c88xxxx
&userEmail=john@example.com
&successRedirectUrl=https://yourapp.com/kyc-success
&failureRedirectUrl=https://yourapp.com/kyc-failed
&theme=dark
URL Parameters
| Parameter | Required | Description |
|---|---|---|
apiKey | Yes | Your merchant API key |
userEmail | No | User's email to skip login |
successRedirectUrl | No | Redirect URL after successful KYC |
failureRedirectUrl | No | Redirect URL after failed KYC |
theme | No | Force light or dark. Omit to follow the user's device setting. See Light & Dark Theme |
Light & Dark Theme
The standalone KYC widget supports light and dark themes.
By default it follows the user's device setting (prefers-color-scheme) automatically. To force a theme, for example to match your own site, add the optional theme parameter to the URL:
https://stg.platform.onmeta.in/kyc/?apiKey=<your_apikey>&theme=dark
theme value | Result |
|---|---|
light | Always light |
dark | Always dark |
| omitted / any other value | Follows the user's device setting |
Webhook Integration
For detailed information on configuring webhooks to receive KYC status updates, see the dedicated webhook configuration page:
KYC Webhook Configuration
👉 Learn how to configure webhooks and receive real-time KYC status updates
Check KYC Status
You can programmatically fetch the KYC status of any user using our API:
Go to Fetch KYC Status API →