Download the PHP package mage2kishan/module-mage-pos without Composer

Panth MagePos — Free Open-Source Point of Sale (POS) for Magento 2 | Hyvä + Luma

Panth MagePos is a free, open-source (MIT-licensed) point of sale extension for Magento 2 (Adobe Commerce and Magento Open Source). It adds a standalone, touch-friendly POS terminal at /pos that is fully theme-independent — pixel-identical on Hyvä, Luma, or any custom theme. It sells your real Magento catalog (all product types, including configurable, grouped, bundle, and custom options) at server-accurate Magento prices, supports cashier roles with PIN unlock, register sessions with X/Z reports, barcode scanning, split payments, 80 mm receipts, refunds, full offline mode with order sync, and a drag-and-drop customizable layout — and every POS sale is a real Magento order.

Panth MagePos turns any Magento 2 store into a retail counter without SaaS subscriptions, middleware, or product sync jobs. The terminal talks directly to your live catalog, customers, inventory (MSI-aware), and order pipeline — every sale lands instantly in sales_order as a normal order with native invoices, tax, credit memos, and reporting. Admins manage registers, POS users, roles, payment methods, quick keys, and reports from a dedicated backend section, and the native Sales Order grid gains POS register and cashier columns.

It is 100% free and open source under the MIT license — no paid tiers, no locked features, no license keys. Contributions, bug reports, and feature requests are welcome.

Table of Contents

• Why Panth MagePos
• Screenshots
• Key Features
  • Standalone Theme-Independent POS Terminal
  • Cashier Authentication, PIN Lock & Roles
  • Register Sessions & Cash Management
  • Catalog, Barcode Scanning & Quick Keys
  • All Product Types with Server-Accurate Pricing
  • Cart: Multi-Cart, Hold/Retrieve, Discounts & Custom Lines
  • Payments: Cash, Offline, Online & Split
  • Receipts
  • Refunds & Returns
  • Offline Mode
  • Fully Customizable Drag-and-Drop UI
  • Full Admin Backend
  • Engineering Quality
• Compatibility
• Installation
• Getting Started
• Configuration
• Roles & Permissions
• Extending Payments (Developers)
• FAQ
• Contributing
• Author & Credits
• License

Why Panth MagePos

Most Magento POS solutions are SaaS bridges: a separate cloud product, a separate product database, monthly fees, and a sync job that breaks at 2 a.m. before your busiest Saturday. Panth MagePos is native and free — the terminal runs inside your Magento installation, sells your real catalog at your real prices, and every sale lands instantly as a normal Magento order.

• Free and open source (MIT) — no subscriptions, no per-register fees, no feature gates
• No middleware, no sync — one source of truth: your Magento database
• Real orders, real accounting — invoices, credit memos, tax, stock deduction, and reports all native
• Theme-independent terminal — a standalone SPA at /pos, pixel-identical on Hyvä and Luma
• Server-accurate pricing — catalog price rules, cart price rules, coupons, tier/group/special prices, and tax are all computed by the real Magento quote, never approximated in the browser
• Keeps selling when the internet doesn't — offline mode caches the catalog in IndexedDB and queues orders for deduplicated sync
• Server-enforced security — every discount cap, price override, refund permission, and even the screen lock is validated server-side, never trusted to the browser
• Make the terminal yours — drag-to-move and drag-to-resize every panel, per-user saved layouts, light/dark themes, accent colors, density and font scaling

Screenshots

Key Features

🖥️ Standalone Theme-Independent POS Terminal

• Touch-first single-page terminal at /pos — big targets (44 px+), numeric keypads, tablet-landscape primary, responsive down to phones
• Rendered as a standalone HTML document outside the theme layout — zero dependency on your storefront theme, so Hyvä, Luma, and any custom theme render it pixel-identically
• Plain Alpine.js + hand-written CSS — no jQuery, no mage/*, no Tailwind dependency, no build step
• The page never scrolls; each panel scrolls internally, so the workspace always fits the screen

🔐 Cashier Authentication, PIN Lock & Roles

• Dedicated POS users (separate from admin users and customers) with username/password login
• Fast PIN unlock after idle auto-lock — full credentials only required once per browser session
• Server-persisted lock: locking the terminal (manually or via the idle timer) is recorded server-side, so a hard refresh still lands on the PIN screen and data endpoints refuse to act while locked
• Roles with granular permissions: maximum discount %, refund, price override, cash in/out, custom products, layout editing, reports
• Passwords and PINs hashed with PHP password_hash() — never stored in plain text

🧾 Register Sessions & Cash Management (X / Z Reports)

• Open a session with an opening float; record cash in / cash out with reasons
• X report (mid-day snapshot) any time; Z report on close with counted cash and automatic over/short reconciliation
• Every cash sale, refund, float, and movement is tracked per session
• Admin can view any session's Z data with paginated cash-drawer movements, or force-close abandoned sessions (auto-close cron included)

📦 Catalog, Barcode Scanning & Quick Keys

• Instant live search by name, SKU, or description; category browsing with reliable anchor/descendant handling; full pagination with infinite scroll
• Top Sellers shown by default, so the catalog panel is never empty after login
• Barcode scanning: keyboard-wedge USB/Bluetooth scanners work out of the box; camera scanning via the browser BarcodeDetector API where available; configurable barcode attribute (defaults to SKU)
• Quick keys: favorite product tiles with custom labels, colors, and pages — manage them in admin or pin products straight from the terminal with the star/pin affordance on any product card
• Product quick-view: tap a card for images, description, salable quantity, and key attributes before adding

🧩 All Product Types with Server-Accurate Magento Pricing

Panth MagePos sells every Magento product type, not just simples:

• Simple products — one tap to add
• Configurable products — a variant picker modal for size, color, and any super attributes
• Grouped products — choose quantities per associated product
• Bundle products — full option selection (radio/checkbox/select/multiselect) with live price recalculation
• Custom options — text, dropdown, checkbox, and other options supported on any product

Selected options are shown in the cart and on the receipt, so cashiers and customers always see exactly what was sold.

Pricing is server-accurate: every cart is a real Magento quote, so catalog price rules, cart price rules, coupon codes, tier prices, customer group prices, special prices, and tax are all honored exactly as on your storefront. All money math happens server-side — the terminal only displays.

🛒 Cart: Multi-Cart Tabs, Hold/Retrieve, Discounts & Custom Lines

• Multi-cart tabs: serve several customers in parallel; hold a cart with a label and retrieve it later from any session
• Discounts, all enforced server-side against the cashier's role cap:
  • Cart-level: percentage or fixed amount off the whole cart
  • Line-level: percentage or fixed amount off a single line (original price stays on the receipt)
  • Price override: set any line price directly (permission-gated)
  • Coupon codes: native Magento cart price rules apply at the terminal too
• Custom sale lines: sell anything not in the catalog — name, price, quantity, optional tax class — backed by a hidden placeholder product so totals, tax, and reporting stay correct
• Order notes, and customer attach with search/create/guest — customer group pricing honored instantly

💳 Payments — Cash, Offline, Online & Split

• Cash: tendered-amount keypad, denomination shortcuts, automatic change due, optional cash-drawer kick
• Offline custom methods: define any number in admin — card terminal, cheque, bank transfer, gift voucher — with an optional mandatory reference field (e.g. terminal approval code) and on-screen instructions
• Online methods: a payment link rendered as a scannable QR code at checkout; the order is placed pending-payment and a PaymentProcessorInterface extension point lets developers wire real gateways
• Split payments: combine any number of methods on one sale — half cash, half card, remainder by payment link
• Fully paid cash/offline orders are auto-invoiced (configurable); every payment row is stored per order and shown on the receipt
• On the Magento side all POS orders use one offline payment method (panth_pos), with per-row detail in the payment's additional information — existing accounting and ERP exports keep working

🧾 Receipts: 80 mm Print, Email, Reprint

• 80 mm thermal-friendly print CSS — prints through the normal browser dialog, so any printer works
• Store logo, configurable header/footer (global + per-register overrides), tax breakdown, payment rows including change, and the selected product options on every line
• Email receipts (manual button or automatic) and reprint any past receipt
• Receipt numbers in the format {register_code}-{session_id}-{seq}

↩️ Refunds & Returns

• Search past orders by increment ID or email, or browse the register's recent POS orders
• Select items and quantities — the refund total is server-computed with the same credit memo math as Magento, so discounted and taxed orders preview the exact amount that will be refunded
• Choose the refund payment split, optional restock toggle (MSI-aware), and a mandatory reason
• Creates a real Magento credit memo and records the matching cash-drawer movement
• Permission-gated per role (can_refund)

📴 Offline Mode

• Catalog cached locally in IndexedDB (configurable item limit)
• On connectivity loss the terminal switches to local search automatically and keeps selling for cash/offline methods
• Completed sales queue locally and sync automatically when the connection returns — the server rebuilds each cart, applies discounts, and places real orders
• Client UUID deduplication guarantees no order is ever created twice, even across retries
• Offline-synced orders are flagged and appear in reports like any other sale

🎨 Fully Customizable UI: Drag, Resize, Themes

• Every panel is freely movable and resizable — catalog, search, quick keys, cart items, cart totals, cart actions, customer, holds, session, toolbar — by simply dragging the panel handle and resizing from the corner, no edit mode required
• 24-column grid with smooth pointer-precise dragging, snap-on-drop, collision-free placement, and graceful degradation (small panels scroll internally, never clip)
• One-click layout presets: classic, mirrored, catalog-max, compact — plus Reset to defaults
• Two named themes: light "Paper" and dark "Ink Console", plus accent color picker, density (comfortable/compact), button scaling, and font scaling
• Everything persisted per POS user — every cashier keeps their own layout and theme on any device

🗂️ Full Admin Backend

• Dedicated admin menu: Launch Terminal, Registers, Sessions, POS Users, Roles, Payment Methods, Quick Keys, Reports, Configuration
• Sales reports: orders, gross, by payment method, by cashier, by hour — filterable by register and date range
• Session view with Z data and paginated cash-drawer movements
• Sales Order grid integration: the native order grid gains POS Register and POS Cashier columns
• Every admin surface ACL-protected under Panth_MagePos::manage

🛡️ Engineering Quality

• Strict types, constructor DI only — no ObjectManager anywhere
• MSI (Multi-Source Inventory) aware: salability and salable quantities resolved per stock; composite products (configurable/grouped/bundle) use type-correct salability; restock on refund returns quantity to the right source — with graceful fallback when MSI is disabled
• All write endpoints are POST with form-key validation; every permission enforced server-side
• Repository interfaces (Panth\MagePos\Api\*RepositoryInterface) for every POS entity
• Unit-tested service layer (discount caps, payment sum/change validation, session cash math, sync deduplication, and more)

Compatibility

Recommended hardware: any tablet or desktop with a modern browser (Chrome / Edge / Safari), an optional USB/Bluetooth keyboard-wedge barcode scanner, and any browser-printable receipt printer (80 mm thermal recommended). No proprietary hardware required.

Installation

Composer (Recommended)

The required dependency mage2kishan/module-core is installed automatically by Composer.

Verify Installation

Then open the terminal at:

and the admin backend at Admin → Point of Sale (MagePos).

Getting Started

A first sale at Acme Store in five minutes:

1. Activate the seeded POS admin user. For security the module never ships a working login — the seeded admin POS user is created disabled with unrecoverable random password/PIN hashes. Go to Admin → Point of Sale (MagePos) → POS Users, edit admin, set a strong password and a PIN, and switch Status to Enabled.
2. Create your registers and cashiers. Add a register per till under Registers (e.g. "Front Counter", code front, bound to a store view). Create one POS user per cashier under POS Users and assign them the Cashier role (10% discount cap, no refunds) — never share logins.
3. Open the terminal. On the till device, browse to https://example.com/pos, log in as the cashier, pick the register, and open a session with the opening float (e.g. 200.00).
4. Ring a sale. Scan a barcode, tap a quick key, or search example-product — configurable/bundle/grouped products open an option picker. Attach a customer for group pricing, or sell as guest.
5. Take payment. Hit Charge, choose Cash (change is calculated automatically), an offline method like Card, an online payment link with QR, or split across several methods.
6. Hand over the receipt. Print to the 80 mm thermal printer, email it (e.g. to [email protected]), or reprint later.

The sale appears immediately under Admin → Sales → Orders with POS register and cashier columns. For the full cashier walkthrough see USER_GUIDE.md.

Configuration

All settings live under Stores → Configuration → Panth → Point of Sale (MagePos):

Registers, POS users, roles, payment methods, and quick keys are managed in their own admin grids under the Point of Sale (MagePos) menu — not in system configuration.

Roles & Permissions

Each POS role defines (all enforced server-side):

Seeded roles: Administrator (everything, 100%) and Cashier (10% cap, no refunds, no overrides) — duplicate and adjust to fit your floor. If a cashier with a 10% cap tries a 15% discount, the server rejects it regardless of what the UI sends.

Extending Payments (Developers)

Wire a real gateway behind any online method by implementing Panth\MagePos\Api\PaymentProcessorInterface:

Register it in your module's etc/di.xml:

Repository interfaces (Panth\MagePos\Api\*RepositoryInterface) are available for every POS entity (registers, sessions, users, roles, payment methods, orders, quick keys, holds, preferences) for programmatic access.

FAQ

Is this Magento POS free?

Yes. Panth MagePos is completely free and open source under the MIT license. There are no paid tiers, license keys, per-register fees, or locked features. You can use, modify, and redistribute it, including commercially.

Does it work with Hyvä?

Yes — and with Luma, and with any custom theme. The terminal is a standalone single-page app rendered outside the theme layout, so it is pixel-identical on every theme. No jQuery, no mage/*, no Tailwind dependency.

Is every POS sale a real Magento order?

Yes. Sales go through Magento's native quote → order pipeline, so invoices, credit memos, tax calculation, stock deduction, and all reporting/ERP integrations work unchanged. POS metadata (register, cashier, receipt number, payment split) is stored alongside, and the Sales Order grid shows POS register and cashier columns.

Does it support configurable, bundle, and grouped products?

Yes — all Magento product types are supported: simple, configurable (variant picker), grouped (per-product quantities), bundle (full option selection with live price recalculation), and products with custom options. The selected options are shown in the cart and printed on the receipt.

How are discounts and price rules calculated?

Server-side, by Magento itself. Every POS cart is a real Magento quote, so catalog price rules, cart price rules, coupon codes, tier prices, customer group prices, special prices, and tax are honored exactly as on your storefront. POS-specific discounts (cart %, line %, fixed, price override) are applied on top and capped by the cashier's role limit — enforced on the server, never trusted to the browser.

Can it work offline?

Yes. With offline mode enabled, the terminal caches a catalog snapshot in IndexedDB and keeps searching and selling (cash and offline payment methods) when the network drops. Completed sales queue locally and sync automatically on reconnect, deduplicated by a client UUID so an order can never be created twice.

Does it handle split payments?

Yes. Any number of payment methods can be combined on one sale — for example half cash and half card. Cash rows may exceed the remaining balance (the difference becomes change); all other rows must sum exactly to the total. Every payment row is stored per order and printed on the receipt.

Is it touch-screen friendly?

Yes. The terminal is touch-first: large targets (44 px minimum), numeric keypads for quantities, prices, and tendered amounts, and a tablet-landscape-primary layout that remains responsive down to phones.

Does it support barcode scanning?

Yes, two ways: keyboard-wedge USB/Bluetooth scanners work with zero setup, and camera scanning is available where the browser supports the BarcodeDetector API. The barcode attribute is configurable (default sku).

Can cashiers have different permissions?

Yes — that is exactly what roles are for. Each role carries a maximum discount percentage plus yes/no flags for refunds, price overrides, session open/close, cash in/out, custom products, layout editing, and reports. All checks are enforced server-side.

How do refunds work?

Search the order by increment ID or email (or browse recent POS orders), select items and quantities, and the refund total is computed server-side with the same math as a Magento credit memo — so discounts and tax are exact. Choose the refund payment split, optionally restock (MSI-aware), give a reason, and a real credit memo is created together with the matching cash-drawer movement.

What hardware do I need?

Any tablet or desktop with a modern browser (Chrome, Edge, Safari). Receipts print through the normal browser print dialog, so any printer works — an 80 mm thermal printer is recommended. Barcode scanners are optional. No proprietary or vendor-locked hardware is required.

Does it work with MSI (Multi-Source Inventory)?

Yes. Product salability and salable quantities are resolved per stock via MSI, composite products use type-correct salability, and refund restock returns quantity to the correct source. When MSI is disabled, the module falls back to legacy stock handling automatically.

Can I run multiple registers or multiple stores?

Yes. Create one register per till, each bound to a store view. Quick keys can be global or per register, receipt header/footer can be overridden per register, and sessions, cash, and reports are tracked per register.

Are there default login credentials?

No — by design. The seeded admin POS user is created disabled with random, unrecoverable password/PIN hashes, so a fresh installation cannot be logged into by anyone. You set your own password/PIN and enable the account in the admin panel before first use.

Can I take integrated card payments?

Out of the box, use an offline method ("Card") with a required reference field — the cashier charges your existing card terminal and records the approval code. For integrated processing, implement PaymentProcessorInterface (see Extending Payments) or use an online payment-link/QR method.

Contributing

Panth MagePos is community-friendly. Contributions of all kinds are welcome:

• Bug reports & feature requests — open a GitHub issue
• Pull requests — keep the rules: declare(strict_types=1), constructor DI only (no ObjectManager), server-side enforcement of all permissions and money math, and unit tests for service-layer changes
• Payment processors — gateway integrations built on PaymentProcessorInterface are especially welcome
• Translations — add your locale to i18n/

Author & Credits

Built and maintained by Kishan Savaliya — kishansavaliya.com — a Top Rated Plus Magento developer on Upwork with 10+ years of eCommerce experience, and Panth Infotech, a Magento 2 development agency specialising in high-quality, security-focused extensions and themes for Hyvä and Luma storefronts.

Need custom POS hardware integrations, payment gateway processors, Hyvä theme development, or Magento performance work? Get a free quote — reply within 24 hours.

License

Panth MagePos is open-source software licensed under the MIT License.

Copyright (c) Kishan Savaliya (Panth Infotech). You are free to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the software, subject to the MIT license terms.

SEO Keywords: magento 2 pos, magento 2 point of sale, magento point of sale extension, magento pos open source, free magento 2 pos, magento 2 pos extension mit, magento 2 pos system, panth magepos, magento 2 cash register, magento 2 retail pos, magento 2 pos terminal, magento 2 in-store sales, magento 2 barcode pos, magento 2 barcode scanner, magento 2 quick keys pos, magento 2 register session, magento 2 x report, magento 2 z report, magento 2 cash management, magento 2 cash drawer, magento 2 pos discount, magento 2 price override, magento 2 split payment, magento 2 split tender, magento 2 pos cash payment, magento 2 pos card payment, magento 2 payment link qr, magento 2 custom sale line, magento 2 pos refund, magento 2 pos credit memo, magento 2 pos receipt, magento 2 80mm receipt, magento 2 thermal printer receipt, magento 2 email receipt, magento 2 offline pos, magento 2 pos offline mode, magento 2 indexeddb pos, magento 2 pos order sync, magento 2 pos hold cart, magento 2 multi cart pos, magento 2 pos pin lock, magento 2 cashier roles, magento 2 pos permissions, magento 2 pos reports, magento 2 pos layout editor, magento 2 touch pos, magento 2 tablet pos, magento 2 configurable product pos, magento 2 bundle product pos, magento 2 msi pos, hyva pos, hyva point of sale, luma pos, magento 2.4.8 pos, magento 2.4.7 pos, php 8.4 pos, mage2kishan, mage2sk, kishan savaliya pos, panth infotech extension, magento 2 omnichannel, magento 2 brick and mortar, adobe commerce pos, free pos for magento