Korona POS API
KORONA POS is a cloud-based, all-in-one point of sale platform for retail, quick-service restaurants, and ticketing venues, covering inventory, CRM and loyalty, payments, and multi-location management. The KORONA Cloud API v3 lets you programmatically pull products, inventory, sales receipts, customers, and supplier records—and push updates like new products, price changes, and stock adjustments back into a KORONA account.
What is Korona POS?
KORONA POS is a cloud-based, all-in-one point of sale system that helps businesses manage sales, inventory, and customer relationships across retail, quick-service, and ticketing operations. Merchants use KORONA to run cloud POS with offline capability, advanced inventory management, CRM and loyalty programs, gift cards, eCommerce integration, multi-location and franchise management, self-checkout kiosks, and reporting through KORONA Studio.
Core product areas include:
- Retail POS (antique shops, bike shops, bookstores, liquor stores, pharmacies, vape shops, wineries)
- Quick Service Restaurant POS (coffee shops, cafes, bakeries)
- Ticketing POS (amusement parks, museums, water parks, event management)
- Inventory management, CRM, and loyalty programs with gift card processing
- KORONA Studio reporting and analytics, self-checkout kiosks, and loss prevention tools
- Multi-location and franchise management with integrated payment processing and hardware
Common data entities:
- Products, Commodity Groups, Assortments, Prices, Tags
- Stocks, Inventory Levels, Stock Receipts, Stock Orders
- Sales Receipts, Receipt Items, Tenders, Payments
- Customers, Customer Groups, Loyalty Cards, Gift Cards
- Suppliers, Purchase Orders, Cashiers, Point of Sale terminals
- Tickets, Events, and Admissions (Ticketing)
The Korona POS Integration Challenge
Merchants run daily sales, inventory, and loyalty workloads on KORONA, but turning a multi-vertical cloud POS into reliable API-driven automation is non-trivial:
- Per-account setup: API access is configured through Settings → Data Exchange, with an Account-ID and credentials added per account, so onboarding differs across every customer tenant
- Basic-auth credentials: The Cloud API v3 uses Basic authentication, and KORONA advises that credentials are passed on every access and can change—so apps cannot store them permanently
- Multiple API surfaces: Cloud API v3, the Ticket Server API, and the Client API each cover different operations and object models, so a single integration must span several endpoints
- Vertical-specific data shapes: Retail, QSR, and ticketing accounts expose different products, assortments, and receipt structures that generic integrations break across
- Multi-location scope: Franchise and multi-store accounts spread products, stocks, and receipts across organizational units that must be reconciled by location
- Pagination and sync volume: High-frequency receipt and inventory data requires careful pagination, revision tracking, and rate handling to stay in sync
How Supergood Creates Korona POS APIs
Supergood combines the KORONA Cloud API v3 with authenticated session flows to deliver a resilient, normalized API layer for your KORONA account—across retail, QSR, and ticketing operations.
- Handles Basic-auth credentials and per-account Account-ID context securely in a managed session
- Maintains session continuity with automated credential rotation and change detection
- Normalizes responses across Products, Stocks, Sales Receipts, Customers, and Suppliers so you integrate once and rely on consistent objects
- Reconciles data across organizational units for multi-location and franchise accounts
Use Korona POS with AI agents: Korona POS MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your account type, modules, and authentication model.
- Supergood Generates and Validates Your API
We deliver a production-ready KORONA adapter tailored to your account configuration and permissions.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as KORONA evolves.
API Endpoints
Authentication
/authenticateAuthenticate to a KORONA account with Basic-auth credentials and the Account-ID to establish a session for downstream calls.
Products
/productsList products with filters for commodity group, assortment, tags, and revision to sync the catalog.
Products
/create_productCreate a new product or update prices and attributes against the account's catalog structure.
Inventory
/stocksRetrieve stock and inventory levels per organizational unit, with stock receipts and order activity.
Sales
/receiptsPull sales receipts, receipt items, tenders, and payments with date-range and location filters.
Customers
/customersList customers, customer groups, loyalty cards, and gift card balances for CRM and loyalty workflows.
Use Cases
Sync product catalog and pricing across locations
- Pull products, commodity groups, and assortments from KORONA into a central catalog - Push new products and price changes back into the account - Reconcile catalog structures across retail, QSR, and ticketing units
Stream sales receipts into BI and accounting
- Pull sales receipts, items, tenders, and payments into a warehouse - Reconcile daily takings and tax across multi-location accounts - Feed downstream BI, accounting, and revenue reporting tools
Keep inventory and stock levels in sync
- Pull stocks and inventory levels per organizational unit - Track stock receipts and orders against suppliers - Trigger reorder and loss-prevention workflows on threshold events
Unify customer and loyalty data
- Sync customers, customer groups, and loyalty cards into a CRM - Reconcile gift card balances across locations - Power targeted loyalty and marketing campaigns from a single profile
Technical Specifications
Authentication
KORONA Cloud API v3 Basic authentication with per-account Account-ID, handled in a managed session
Connectivity
KORONA Cloud API v3 plus authenticated session flows, with Ticket Server and Client API surfaces where exposed
Response format
Normalized JSON across Products, Stocks, Sales Receipts, Customers, and Supplier objects
Rate limits
Adaptive throttling tuned to your KORONA account to avoid vendor-side limits
Session management
Automatic credential rotation and re-auth handling for Basic-auth credentials that can change
Data freshness
Near real-time pulls for receipts, products, and stocks with optional scheduled batch syncs
Security
Encrypted credential vault, scoped access, SOC 2-aligned controls, and audit logging
Webhooks
Event-style callbacks for receipt posting, product changes, stock movements, and customer updates
Latency
Sub-second reads on cached entities; multi-second writes when posting products and stock adjustments
Throughput
Horizontally scaled workers sized to high-volume receipt and inventory data across locations
Reliability
Retry, backoff, and idempotency keys for product, stock, and receipt operations
Adaptation
Continuous monitoring of KORONA Cloud API v3 releases and per-account configuration drift
Frequently asked questions
Yes. Supergood normalizes products, receipts, stocks, and customers across retail, quick-service restaurant, and ticketing KORONA accounts, so you integrate once across all three verticals.
The Cloud API v3 uses Basic authentication with an Account-ID configured under Settings → Data Exchange. Supergood manages those credentials securely and handles rotation, since KORONA passes them on every access and they can change.
Yes. Supergood reconciles products, stocks, and receipts across organizational units, so multi-location and franchise accounts surface consistent, location-aware data.
Yes. Beyond reads, the API supports writes such as creating products, updating prices, and posting stock adjustments back into your KORONA account.
No. Supergood works with your existing KORONA account credentials and API access configured under Data Exchange—no separate partner program approval is required to get started.