Getting Started

Step 1 — Create your account

Sign in with your Google account at developers.wynai.pro. Any WynAI account works — no separate developer registration needed.

Step 2 — Submit your app

Go to My Apps → Submit App and fill in:

• App NameDisplayed in the WynAI App Store.
• Short DescriptionOne-liner shown on the app card (max 120 chars).
• Icon URLHTTPS image URL, 512×512px recommended.
• App URL (iframe)Your app's URL. WynAI loads this in an iframe. Must be HTTPS.
• CategoryHelps users discover your app.
• PricingFree or Paid (set price in WynAI points). 80% revenue goes to you.
• Webhook URLOptional. Receive purchase/install events in real-time.

Step 3 — Review process

After submission, your app status becomes pending_review. Our team checks it within 24 hours. You'll receive a notification when it's approved.

Common rejection reasons: broken iframe URL, invalid icon, misleading description. Fix and resubmit anytime.

Step 4 — Get your API credentials

Once submitted, go to My Apps → Key icon to view your client_secret. Store it securely on your server — you'll use it to verify webhook signatures.

Step 5 — Handle INIT_SESSION

When a user opens your app in WynAI, the AppLauncher sends an INIT_SESSION message to your iframe. Implement this in your app:

window.addEventListener('message', (event) => {
  // Validate origin in production!
  // Allowed: *.wynai.pro, *.wordai.pro
  if (event.data?.type === 'INIT_SESSION') {
    const { token, userId, locale, theme } = event.data;
    // Verify token on your backend:
    // POST /your-api/auth { token } → your server calls Firebase Admin
    initApp(token, userId, locale, theme);
  }
});

// Tell WynAI your app loaded successfully
window.parent.postMessage({ type: 'APP_READY' }, '*');

See Authentication for token verification details and Building Your App for the full IPC spec.