Panth MagePos Point of Sale

What you get

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)

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.

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)

composer require mage2kishan/module-mage-pos
bin/magento module:enable Panth_MagePos
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

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

Verify Installation

bin/magento module:status Panth_MagePos
# Expected: Module is enabled

Then open the terminal at:

https://example.com/pos

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 customer@example.com), 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.

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

Extending Payments (Developers)

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

declare(strict_types=1);

namespace Acme\PosStripe\Model;

use Magento\Sales\Api\Data\OrderInterface;
use Panth\MagePos\Api\PaymentProcessorInterface;

class StripeProcessor implements PaymentProcessorInterface
{
 public function supports(string $methodCode): bool
 {
 return $methodCode === 'stripe_link';
 }

 public function process(OrderInterface $order, array $paymentRow): array
 {
 // Create a payment intent / checkout link for $paymentRow['amount'] ...
 return [
 'status' => 'pending', // 'paid' or 'pending'
 'reference' => 'pi_123', // gateway reference
 'redirect_url' => 'https://example.com/pay', // shown as link + QR at the terminal
 ];
 }
}

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

<type name="Panth\MagePos\Model\Payment\ProcessorPool">
 <arguments>
 <argument name="processors" xsi:type="array">
 <item name="stripe_link" xsi:type="object">Acme\PosStripe\Model\StripeProcessor</item>
 </argument>
 </arguments>
</type>

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.