Skip to main content

🧪 Live Widget Testing (V1)

Test the Onmeta Widget right here in our documentation! This interactive playground allows you to configure and test the widget with your own API key without leaving the page.

⚡

Quick Testing Guide

  1. Enter your API key from the dashboard
  2. Configure optional parameters (wallet address, amount, etc.)
  3. Click "Launch Widget" to test
  4. Complete a test transaction to see the full flow

Testing Guide​

1️⃣ Prerequisites

  • Registered account on staging dashboard
  • Valid API key copied from dashboard
  • Browser with JavaScript enabled

2️⃣ Configuration

  • Enter your staging API key
  • Set optional parameters as needed
  • Click "Launch Widget" button

3️⃣ Testing

  • Complete KYC verification
  • Add bank/UPI details
  • Create test transaction
Testing Best Practices
  • Start with minimal configuration (just API key)
  • Test different parameter combinations
  • Monitor the event console for debugging
  • Try various currencies and amounts
  • Test on different devices/browsers

URL Parameter Testing​

You can also test the widget by passing parameters in the URL. Simply add query parameters to this page URL:

?apiKey=8794c88xxxx&fiatAmount=100&fiatType=inr&walletAddress=0xXXX

Example:

/docs/widget/live-testing?apiKey=your_api_key&fiatAmount=500&fiatType=inr
💡 Tip:

Share configured widget URLs with your team for quick testing

Common Test Scenarios​

Scenario 1: Basic Widget Test

Configuration:
  • API Key: Your staging key
  • Environment: Staging
  • All other fields: Empty

Expected Result: Widget loads, user can enter all details manually

Scenario 2: Pre-filled Amount

Configuration:
  • API Key: Your staging key
  • Environment: Staging
  • Fiat Amount: 1000
  • Fiat Type: inr

Expected Result: Widget loads with amount pre-filled to 1000 INR

Scenario 3: Specific Token Selection

Configuration:
  • API Key: Your staging key
  • Environment: Staging
  • Chain ID: 137
  • Token Symbol: USDT

Expected Result: Widget shows only USDT on Polygon

Scenario 4: Complete Pre-configuration

Configuration:
  • API Key: Your staging key
  • Environment: Staging
  • Wallet Address: Your test wallet
  • Fiat Amount: 500
  • User Email: test@example.com
  • Chain ID: 137
  • Token Symbol: USDT

Expected Result: Widget loads with all fields pre-filled, user just confirms

What's Next?​

👉 User Flow in Widget - See the complete user journey from login to order completion with detailed flow diagrams for INR, PHP, and IDR