🎯 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
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 |
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 →