eSIMQR - Java eSIM Store and Reseller Platform icon

eSIMQR - Java eSIM Store and Reseller Platform

Hot or Not
eSIMQR - Java eSIM Store and Reseller Platform

Description

eSIMQR is a self-hosted travel eSIM commerce platform with a storefront, reseller portal, administration interface, Java API and eight supplier or payment plugins.

Customers can browse destinations, purchase plans and receive eSIM QR codes. Resellers have partner pricing and a prepaid wallet, while staff manage orders, catalogues, pricing, refunds and reports.

The package includes editable source, Docker configuration, deployment guides and test supplier/payment integrations. Real sales require your own funded supplier accounts, payment accounts, hosting and domain.

Read the verification table in README.md before deployment. Some integrations have only been exercised in test environments; the Airalo plugin was tested against a simulated API rather than live provisioning.

Features

  • Storefront for travellers
    • Country and region pages, cart and checkout, QR code by e-mail, order page with usage and top-ups.
    • 10 languages in the storefront and in every e-mail: English (default), Vietnamese, Chinese, Japanese, Korean, Thai, Indonesian, Spanish, French and German, with language-prefixed URLs and hreflang tags.
    • Guest checkout and customer accounts, install guides for iOS and Android, compatible-device pages, FAQ and legal pages.
  • Reseller (agent) portal
    • Partner pricing, a prepaid wallet with card top-ups, credit limits, referral links with commissions.
    • Agents place orders, resend eSIMs, see usage and top up their customers' eSIMs.
  • Back office
    • Orders, eSIMs, customers, agents and wallets, refunds, retries for failed deliveries.
    • Catalogue and pricing rules: markup or supplier recommended price, rounding, minimum margin, currency rate, per-package overrides.
    • Reports, audit log, users and roles, integrations with per-plugin configuration and health, settings.
  • Plugins (signed HTTP contract, SDKs for Node.js, Java and Python)
    • eSIM suppliers: Airalo, eSIM Access, eSIM Go, YonoSIM.
    • Payments: Stripe, PayPal, Paddle Billing, Airwallex.
    • Idempotent orders and refunds, HMAC-signed requests, a replay window, and an admin page in every plugin.
  • API
    • Java 21, Spring Boot 3.5, PostgreSQL, Flyway migrations, JWT, OpenAPI documentation.
    • Provisioning with retries and backoff, payment reconciliation, wallet ledger, e-mail delivery of QR codes.
  • Ready to run
    • Docker Compose for local use and for one server, nginx templates, deployment scripts driven by one settings file.
    • Sample-data script, end-to-end smoke test, backups, and a demo mode with published test accounts and test-card details.
    • Automated tests for the API, every plugin and the SDKs.

Requirements

  • To try it locally: Docker with Compose v2 and Node.js 22 (or Java 21, Maven 3.9, Node.js 22 and PostgreSQL without Docker)
  • To run it for real: a Linux server with Docker, nginx, SSH access and at least 4 GB RAM, and a domain name
  • Accounts at the eSIM suppliers and payment gateways you want to connect (none are needed to install and try the shop)
  • Optional: an SMTP account for order e-mails; Cloudflare or any DNS provider
  • A modern browser (Chrome, Edge, Firefox, Safari)

Instructions

  1. Unzip the package and read docs/INSTALL.md.
  2. Run docker compose up -d --build in the root folder. It starts PostgreSQL and the API with the built-in test supplier and test payment gateway.
  3. Start the two web apps: cd esim-web && npm install && VITE_PROXY_TARGET=http://localhost:8080 npm run dev and cd agency-portal && npm install && API_PROXY_TARGET=http://localhost:8080 npm run dev.
  4. Open http://localhost:5311 (storefront) and http://localhost:5310 (back office, sign in with the local administrator from docker-compose.yml). Buy something with "Test payment".
  5. Optional: ./scripts/seed-demo.sh fills the installation with sample resellers and orders.
  6. To go live: copy deploy/deploy.env.example to deploy/deploy.env, enter your server and domains, run ./deploy/deploy-server.sh, then ./deploy/configure-providers.sh to connect your supplier and gateway accounts. The install guide in the docs folder covers DNS, TLS, webhooks, e-mail, the go-live checklist, updates, backups and troubleshooting.

The README and the docs folder cover the architecture, the plugin contract, operations and the list of what was and was not verified for each provider.

AuthorSourceBento
CategoryScripts & Code / Java
Price$999
Extended License$2,997
Likes1
First ReleaseSep 30, 2026
Last UpdateSep 30, 2026
DatabasePostgreSQL 17
Files included.py, .css, .html, .ts, .jsx, .json, .svg, .sql, .md, .yml/.yaml, package.json, Dockerfile, .java, .xml, JavaScript .js
Software versionPython 3.12, Node.js 22, Java 21
Html/css frameworkTailwind CSS
Software frameworkReact, Spring Boot
Javascript frameworkReact, Express.js, Node.js
Programming languageJavaScript, TypeScript, Python, Java

External listing. code.market does not sell this product and does not process payment for it. Pricing, payment, delivery, licensing, refunds, and support are handled by the third-party merchant on its own website. We may earn an affiliate commission from a referral. Details.