SettingsUpdated 2026-06-01
POS settings
Configure in-person selling: terminals, payments, tax, receipts, and offline mode.
Saleporia POS turns any supported device into a point-of-sale terminal. Configure payments, tax, receipts, and offline behavior.
Where to find it
Settings → POS. Toggle enabled and configure terminal behavior.
POS configuration
| Field | Type | Description |
|---|---|---|
| storeDisplayName | string | Name shown on the POS terminal and receipts. |
| payments | flags | Enable cash, card, mobile wallet, store credit, and split payments. |
| tax | object | Tax rate, inclusive/exclusive, and label. |
| receipt | object | Header, footer, logo, auto-print, and customer copy settings. |
| staffPIN | string | Staff PIN for terminal access. Masked after saving. |
| barcodeSearchMode | enum | sku, barcode, or both — how product lookup by code behaves. |
| offlineMode | boolean | Allow offline sales with a sync interval. |
| discounts | object | Enable terminal discounts and set a max percentage. |
| refunds | object | Enable refunds and set a window in days. |
Terminals
Register POS terminals under shop settings. Each terminal gets an auto-generated access key for authentication. Rotate or revoke keys as needed. Terminals look up products by SKU or barcode via the POS endpoint.
POS endpoints
POST
/shop/pos/terminalsRegister a POS terminal (label, location). Auto-generates access key.
SessionPOST
/shop/pos/terminals/:id/rotate-keyRotate a terminal access key.
SessionGET
/pos/products/by-codeLookup a product by SKU/barcode per the shop's barcodeSearchMode.
Terminal key