New retail cash management capabilities

We've rebuilt cash management on Shopify POS from the ground up. The new Admin GraphQL APIs and POS UI extension targets open up cash management data and controls to app developers, enabling custom cash management workflows that were previously impossible to build on Shopify POS.

What's new

Cash Drawers

CashDrawer is a new resource that decouples cash management from individual POS devices. A cash drawer represents a physical cash storage unit at a location. Multiple devices can connect to a single drawer, enabling flexible store setups.

Resource	Description
`cashDrawers`	Query all drawers across locations, including balances and activities. Query connected devices via the `pointOfSaleDevices` connection
`cashDrawerCreate`	Create a new named cash drawer at a location
`pointOfSaleDeviceAssignToCashDrawer`	Assign a POS device to a cash drawer, establishing the device-to-drawer relationship

Payment sessions

PointOfSaleDevicePaymentSession replaces CashTrackingSession as the primary resource for cash sessions. A payment session represents a period when a cash drawer is actively in use , typically one shift or one business day, and tracks all cash movements from open to close.

Resource	Description
`pointOfSaleDevicePaymentSessions`	Query sessions, with filters for `status`, `opening_time`, and `closing_time`
`pointOfSaleDevicePaymentSessionOpen`	Open a new payment session
`pointOfSaleDevicePaymentSessionClose`	Close sessions. The API will calculate expected balance and discrepancies
`pointOfSaleDevicePaymentSessionAdjust`	Record a cash adjustment during an active session

Sessions now include financial summary fields for reconciliation: totalCashSales, totalCashRefunds, netCashSales, totalAdjustments, totalDiscrepancy, totalSales, totalRefunds, and netSales.

Reason codes

CashManagementCustomReasonCode is a new resource that lets merchants categorize cash adjustments. Shopify provides a set of default codes, and merchants can create custom codes to match their operations.

Resource	Description
`cashManagementReasonCodeCreate`	Create a custom reason code with a human-readable name and machine-readable code
`cashManagementReasonCodeDelete`	Delete a reason code

POS UI extensions

New extension targets and APIs give developers the ability to build custom experiences directly on POS cash management surfaces:

Resource	Description
Register details block and action targets	Render custom UI on the register screen (available in API version `2026-04`)
Cash Drawer API	A new platform API accessible from POS UI extensions for interaction with the cash drawer
`deviceId` on Session API	Extensions can now read the current POS device ID to fetch the corresponding `PointOfSaleDevice` data via the Admin API

Learn more

Was this section helpful?