eSimScan – AI-Powered eSIM Data Plan Marketplace Script | PHP React

Third-party costs: eSimScan integrates with external services such as OpenAI, DeepSeek, and Stripe (and other providers you configure). Those services bill you directly based on your usage and pricing; those fees are not included in the CodeCanyon purchase price. You must supply your own accounts, API keys, and budgets for any third-party APIs or payment processors you enable.

esimScan is a production-ready application for selling eSIMs online. Run a complete travel-data store end to end: a public storefront where customers browse data plans by country and region, guest checkout with Stripe and PayPal, automatic eSIM delivery by email (QR code + activation details), and a single admin back-office to run everything—orders, suppliers, catalog, customers, KYC, marketing, payments, and system settings. Connect leading eSIM suppliers (Airalo, eSIM Access, Maya Mobile, eSIM Go), sync their catalogs, set your margin, and fulfill orders manually, in demo mode, or live via the provider API.

Third-party costs: esimScan integrates with external services such as eSIM suppliers (Airalo, eSIM Access, Maya Mobile, eSIM Go), payment processors (Stripe, PayPal), and AI providers (OpenAI, Claude / Anthropic, or DeepSeek — you choose which one to use). Those services bill you directly based on your usage and pricing; those fees are not included in the purchase price. In particular, the optional AI features cost nothing extra to buy, but each AI request is billed to your own AI-provider account — you supply the API key and budget. You must supply your own accounts, API keys, wholesale eSIM credits, and budgets for any third-party APIs or payment processors you enable.

Why esimScan?

• Sell eSIMs end to end – Public storefront with country and region browsing, guest checkout, payment, and automatic eSIM delivery (QR + activation) by email—no customer login required.
• Multi-supplier supply chain – Connect Airalo, eSIM Access, Maya Mobile, and eSIM Go; test the connection, sync packages, top-ups, regions, and countries, and set your selling margin.
• Flexible fulfillment – Choose how a paid order becomes a delivered eSIM: manual (staff deliver), stub (instant demo data), or live (auto-issue via the provider API).
• One admin back-office – Run the whole store from /admin: dashboard, orders, custom & top-up orders, providers, catalog, customers, KYC, marketing, support, and reporting.
• Marketing built in – Vouchers, gift cards (single or bulk), and a referral program—codes validated server-side at checkout.
• AI assistant (optional) – An AI eSIM Advisor on the storefront recommends the right plan from your own catalog, and a “Suggest reply” button drafts support answers for agents. Bring your own key for OpenAI, Claude (Anthropic), or DeepSeek—pick one in admin.
• Storefront payments – Take payment with Stripe and PayPal, with a clean success/confirmation flow.
• Optional customer accounts – Buyers can register to track their eSIMs, orders, KYC, and support tickets—while guest checkout stays the default.
• Global by design – Multi-currency and multi-language with full RTL support (English, Bangla, Arabic, Hindi out of the box; add more from admin).
• Security-minded – Role-based access control, encrypted provider credentials, KYC documents on a private disk, audit logs, secure headers, and an optional demo mode for safe exploration.
• Documentation included – VuePress guides: setup, production deployment, aaPanel, storefront/customers, admin, and eSIM provider configuration.

Core modules & features

Storefront & checkout

• Browse eSIMs by destination, popular packages, and all-in-one plans
• Guest checkout with email + phone—no account required
• Vouchers and gift-card codes applied live at checkout
• Stripe and PayPal payment, with a success/confirmation flow
• Optional customer account: my eSIMs, orders, profile, KYC, and support

eSIM delivery & fulfillment

• Order lifecycle: paid → provisioning → fulfilled → delivered (refund/cancel supported)
• eSIM emailed with a scannable QR code and manual details (SM-DP+ address + activation code) via a signed URL
• Three provisioning modes via ESIM_PROVISIONING_DRIVER: manual, stub, live
• Auto-provision on payment and editable delivery email template (esim_delivery); failed live orders fall back to manual

Suppliers & catalog

• Connect Airalo, eSIM Access, Maya Mobile, eSIM Go—credentials stored encrypted
• Test connection, then sync packages, top-ups, regions, and countries
• Per-provider and per-package margin control; enable/disable packages
• Configurable sync interval and rate limits (MASTER_ESIM_SYNC_MAX_SECONDS)

Orders & customers

• Every sale in one place: fulfill, resend, refund, cancel, complete
• Manually create custom orders and top-up orders
• Customer records (auto-saved from checkout); block/unblock
• KYC verification with documents streamed from a private disk

Marketing

• Discount vouchers (percentage or fixed)
• Prepaid gift cards—send individually or bulk-generate
• Referral program with reward settings and exports

AI assistant (optional)

• Choose your AI provider in Admin → AI Settings: OpenAI, Claude (Anthropic), or DeepSeek—API key stored encrypted, with a one-click “Test connection”
• AI eSIM Advisor – A storefront widget where a shopper describes their trip and gets matching plans from your own catalog, each deep-linking into checkout (recommendations are grounded in your packages, not invented)
• Support reply drafting – A “Suggest reply” button on admin and reseller support tickets drafts a response from the conversation and the customer’s orders; the agent edits before sending (never auto-sends)
• Each feature has its own on/off toggle; all AI calls use the API key and budget from your provider account (billed by them, not included in the purchase price)

System & settings

• Email system: multiple SMTP configurations + editable email templates
• Currencies (formats & exchange rates) and languages (i18n + RTL)
• Roles & permissions (RBAC), admin users, and audit logs
• Website templates for storefront/landing pages
• Branding, general settings, in-app notifications
• Reporting: analytics, profit/margin, reviews
• Optional demo mode (APP_DEMO_MODE) to block writes in demos
• Single root .env (Vite exposes VITE_* only)

Integrations (as configured)

• eSIM suppliers: Airalo, eSIM Access, Maya Mobile, eSIM Go
• Payments: Stripe and PayPal for storefront checkout
• SMTP for eSIM delivery, verification, password reset, and notifications
• AI providers: OpenAI, Claude (Anthropic), DeepSeek—pick one in Admin → AI Settings (bring your own key); Google sign-in (Firebase) for the storefront

Store-owner workflow

esimScan is built for running an eSIM-selling business from one back-office:

• Email System – Add and activate SMTP so eSIM/QR emails can be delivered.
• Payment gateways – Connect Stripe/PayPal so customers can pay at the storefront.
• Providers – Add supplier API credentials, test, and sync their catalog into your store.
• Margin & catalog – Set your margin and curate which packages are sellable.
• Marketing – Create vouchers, gift cards, and referral rewards.
• AI (optional) – Add an OpenAI, Claude, or DeepSeek API key in AI Settings, enable the eSIM Advisor and/or support reply drafting. Billed by your AI provider; off by default.
• Operate – Watch orders, fulfill and deliver eSIMs, handle support, and review the dashboard and reporting.
• Docs & hosting – VuePress documentation in docs/; build static docs with npm run build (from docs/) for hosting.