# Paymob Integration Onboarding Wizard

An interactive AI-guided planner that helps merchants integrate Paymob payment APIs. Generates a personalised integration roadmap based on business type, tech stack, and market (Egypt · KSA · UAE · Pakistan · Rwanda · others).

## Key Capabilities

- **Integration Plan Builder** – step-by-step wizard collecting business type, platform (Web/Mobile/E-commerce/Payment Links), coding preference, and monthly volume.
- **Live Code Lab** – tabbed IDE with runnable SDK samples, HMAC signature validator, webhook replayer, request linter, and scorecard.
- **AI Assistant (Mobe)** – streaming chat powered by OpenRouter for guided integration Q&A.
- **Speech Input** – OpenRouter audio transcription proxy for voice-driven wizard navigation.
- **Support Ticket** – submit tickets directly to Paymob Freshdesk from the wizard.

## API Endpoints

| Method | Path | Description |
|--------|------|-------------|
| GET | /api/health | Health check |
| POST | /api/transcribe | Speech-to-text (Whisper ASR proxy) |
| POST | /api/tts | Text-to-speech (neural voice; falls back to browser speech) |
| POST | /api/ask-ai | AI assistant — Server-Sent Events stream |
| POST | /api/support/ticket | Submit Freshdesk support ticket |

## Integration Paths Covered

- **Web / REST API** – Custom checkout with Paymob REST API + HMAC v2 signatures
- **Mobile** – iOS & Android SDK
- **E-commerce** – Shopify, WooCommerce, Magento plugins
- **Payment Links** – No-code links for invoicing, social commerce (Instagram/TikTok/Facebook), WhatsApp orders, freelance, donations, events, subscriptions, education

## Useful Links

- Paymob Developer Portal: https://developer.paymob.com
- Paymob Dashboard: https://my.paymob.com
- Paymob API Reference: https://docs.paymob.com