Testing

This page explains how to validate your TwoCoin widget integration before production rollout. Use this checklist to test core user flows, failure scenarios, and operational monitoring.

Test Environments

Validate the widget in staging first, then run a final smoke test in production after deployment.

Integration Test Checklist

• •
  Widget iframe loads correctly on desktop and mobile layouts
• •
  Configured URL parameters are applied correctly (currencies, wallet, region, visibility flags)
• •
  Normal order flow reaches completion and exposes expected client events
• •
  Failure paths are handled with clear user messaging and no broken UI states
• •
  Order status updates are persisted in your backend through verified webhooks

Automated Smoke Example

Add a browser test that confirms the widget is reachable and interactive after each deploy.

// Example Playwright smoke test
import { test, expect } from '@playwright/test';

test('widget page renders and iframe loads', async ({ page }) => {
  await page.goto('https://your-site.com/docs/widget/getting-started');
  const frame = page.locator('iframe[title="TwoCoin Widget"]');
  await expect(frame).toBeVisible();
});

Webhook Validation

Test webhook handling with signature verification and idempotency logic before going live.

// Pseudo-test flow for webhook reliability
1. Create test order in widget
2. Capture webhook payload + signature
3. Verify signature on your server
4. Retry the same payload (duplicate) and ensure it is ignored safely
5. Confirm database status matches latest webhook state

Pre-Launch Readiness

Next Steps