🚀 KUQUID Developer Quickstart

1 Contact us at hello@kuquid.com to get your API keys.

You'll receive:

• pk_live_... — Production API Key
• pk_sandbox_... — Sandbox API Key (for testing)

2 Add the KUQUID Consent Widget to your web app.

The widget handles the entire consent flow — your users see clear toggles, earnings estimates, and a confirmation screen.

<script src="https://cdn.kuquid.com/sdk/v0.1/kuquid-widget.js"></script>
<script>
  KUQUID.showConsentWidget({
    apiKey: 'pk_live_YOUR_KEY',
    appUserId: currentUser.id,
    brandName: 'Your Brand',
    purposes: [
      { id: 'purpose_ads', name: 'Personalized Ads', description: '...', estimatedEarnings: '$1.00' }
    ],
    onConsent: async (data) => {
      // Send to your backend, which calls KUQUID API
      await fetch('/api/kuquid/consent', {
        method: 'POST',
        body: JSON.stringify(data)
      });
    }
  });
</script>

3 When a user grants or revokes consent, send it to the KUQUID API via your backend.

curl -X POST https://kuquid-api.onrender.com/v1/consent \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: unique-key-here" \
  -d '{
    "app_user_id": "user_123",
    "purpose_id": "purpose_ads",
    "action": "grant",
    "consent_duration_days": 365,
    "terms_version": "v1.0",
    "email": "user@example.com"
  }'

4 Every time you use a user's consented data, record a usage event.

curl -X POST https://kuquid-api.onrender.com/v1/events \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: unique-key-here" \
  -d '{
    "app_user_id": "user_123",
    "purpose_id": "purpose_ads",
    "event_type": "ad_impression",
    "timestamp": "2026-07-22T12:00:00Z"
  }'

KUQUID handles everything else:

• ✅ Cryptographic consent ledger with public verification
• ✅ Monthly Data Dividend calculation
• ✅ Automated payout processing via Stripe Connect
• ✅ Brand Dashboard with analytics and audit reports
• ✅ End User Dashboard for earnings and consent management