Description

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 – AI-Powered eSIM & Data Plan Marketplace Script | PHP React

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.

Demo

Email: admin@spagreen.net
Password: 123456

Email: client@spagreen.net
Password: 123456

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.

Tech stack

Frontend:

• React 19 with Inertia.js (SPA feel, server-driven routing)
• Vite for development and production builds
• Tailwind CSS
• i18next / react-i18next for internationalization (with RTL)
• sonner for app-wide toast notifications

Backend:

• PHP 8.2+ with Laravel 12
• MySQL 8+ (SQLite supported for local development)
• Redis optional for cache/queue (database fallback included)
• Queue worker for provisioning, emails, and catalog syncs; scheduler for periodic tasks
• Separate guards for storefront customers and the admin back-office

Documentation:

• VuePress site under docs/ (setup, deployment, aaPanel,
  storefront/customers, admin, eSIM provider configuration)

Installation (quick overview)

Full steps are in the repository README and docs/guide/setup.md.
Summary:

1. Prerequisites – PHP 8.2+, Composer 2, Node.js 18+, MySQL 8+,
   Git
2. Clone & install – composer install and
   npm install
3. Environment – Copy .env.example to
   .env; run php artisan key:generate; set
   APP_URL, DB_*, MAIL_*, and
   ESIM_PROVISIONING_DRIVER
4. Database – Create a MySQL database and run
   php artisan migrate --seed, then
   php artisan i18n:seed-defaults
5. Build & run – npm run build (or
   npm run dev), then php artisan serve; run
   php artisan queue:work for background jobs
6. Production – See README_DEPLOYMENT.md and the
   aaPanel guides in docs/guide/ (PHP-FPM, queue worker,
   scheduler, SSL)

Documentation index: see docs/README.md in the repository.

System requirements

• PHP 8.2 or higher (with pdo_mysql, mbstring, openssl, bcmath, curl, gd)
• MySQL 8.0 or higher (SQLite for local development)
• Composer 2 and Node.js v18 or higher
• Minimum 2GB RAM (4GB+ recommended for production)
• Modern browser (Chrome, Firefox, Safari, Edge)
• Production: a persistent queue worker and the scheduler (cron) so eSIM
  delivery, provisioning, and catalog syncs run reliably

Changelog

Version 1.0.0 – Initial release

• eSIM store & travel-data reseller (Laravel 12 + Inertia/React)
• Public storefront with guest checkout, Stripe/PayPal, and automatic eSIM
  delivery (QR + activation) by email
• Multi-supplier integration (Airalo, eSIM Access, Maya Mobile, eSIM Go) with
  catalog sync, margins, and manual/stub/live fulfillment
• Admin back-office: orders, providers, catalog, marketing, customers, KYC,
  reporting, email, currencies, languages, and RBAC
• Multi-currency, multi-language with RTL, audit logs, and demo mode
• Optional AI assistant: storefront eSIM Advisor and support reply drafting,
  powered by your choice of OpenAI, Claude (Anthropic), or DeepSeek
• VuePress documentation for setup, deployment, and configuration

Support & notes

Documentation first – Read the guides in the
docs/ folder (or your hosted docs site): setup, storefront &
customers, admin, and eSIM provider configuration.

Support – For technical issues, use your marketplace or
repository support channel. Include error messages, steps to reproduce,
PHP/MySQL versions, and relevant .env variable names (not secret
values).

Important notes:

• Keep APP_KEY stable—provider API credentials are stored
  encrypted with it; changing it makes saved credentials unreadable.
• eSIM delivery emails require an active SMTP configuration (Admin → Email
  System) and a running queue worker.
• Live auto-issuing requires valid eSIM provider credentials and wholesale
  credit/balance with that provider.
• Scheduled tasks and background jobs require the queue worker and scheduler to
  run continuously in production.
• Description images are in codecanyon/description/. Upload them to
  your own server/CDN and replace the relative src paths in this
  file with the hosted https URLs before publishing (CodeCanyon does not host
  description images). Upload codecanyon/thumbnail.png (80×80) and
  codecanyon/inline-preview.png (590px) in Envato’s item uploader.

ESimScan is a PHP and React application for running an online store that sells travel eSIMs and mobile data plans. Customers can compare plans by country or region, pay at checkout, and receive eSIM activation details by email. Store owners can manage plans, orders, customers, payments, discounts, support, and supplier connections from one admin area. It can connect to eSIM providers to sync available plans and fulfill orders. Optional AI tools can help customers choose plans and help support staff draft replies. It is for eSIM resellers, travel-data businesses, and developers building an eSIM marketplace.