What Are Miniapps
What Are Super Qi Miniapps?
Super Qi Miniapps are lightweight, WebView-based applications that run within the Super Qi ecosystem. They provide app-like experiences without requiring separate downloads or installations.
Platform Architecture
WebView-Based Runtime
Miniapps run in a secure, sandboxed execution environment that ensures consistent rendering across devices while remaining isolated from the host application.
Unified Authentication
The platform provides single sign-on across all Miniapps using OAuth-based token management. Users don't need to create separate accounts for each Miniapp they use.
Native Payment Integration
Super Qi integrates with QiCard (Iraq's digital payment solution) and Alipay+ (global payment network) to enable in-app transactions without external redirects. The platform supports both one-time and recurring payments.
Security & Permissions
Each Miniapp runs in sandboxed execution with a declarative permission model that provides fine-grained API access control.
Miniapps Structure
Miniapps consist of three main components: the Frontend, the Backend, and the Super Qi App.
How It Works
| Component | Hosted By | Dependencies |
|---|---|---|
| Frontend | Merchant | URL provided to Super Qi Console |
| Backend | Merchant | None with Super Qi |
| Super Qi App | Super Qi | URL from Console to display the Miniapp |
The merchant is responsible for hosting both the frontend and the backend of their Miniapp. The only dependency between the Super Qi app and your Miniapp is the URL you provide to the Super Qi Console.
- Backend: Has no dependencies with Super Qi. You can use any technology stack, hosting provider, or architecture that suits your needs.
- Frontend: The only connection to Super Qi is the URL that the platform uses to load your Miniapp. Super Qi relies on this URL to generate the QR code and display your Miniapp within the Super Qi app.
Recommended Approach for Payment Handling
Super Qi does not recommend having a direct dependency between each payment and a product in your Miniapp system. The recommended approach is to track every payment in the merchant's backend. This ensures you have full control over transaction records, can reconcile payments independently, and maintain a reliable audit trail for all financial transactions in your system.
Key Features
Deep-Linking & QR Triggers
The platform supports versioned URIs for direct navigation to specific features and QR code entry points for offline-to-online experiences. You can pass dynamic parameters and track marketing campaigns through these entry points.
Platform APIs
Miniapps have access to essential capabilities including user profile and authentication, payment processing and refunds, device features like camera and location, and UI components such as dialogs and notifications.
Development Environments
Super Qi UAT (Testing)
The UAT environment is designed for development and testing. It provides test payment processing (no real money), isolated data separate from production, and debugging capabilities.
Super Qi Production
The production environment handles live user transactions with real payment processing. All Miniapps require approval before deployment to this environment.
Common Use Cases
Miniapps power various services across Iraq's digital economy including e-commerce and shopping, loyalty programs, financial services, on-demand services, and entertainment and media.
Next, explore the MiniApps Lifecycle to understand the end-to-end journey your Miniapp takes — from signing the commercial contract all the way to going live.