PDV — overview

:::info Current state The PDV already charges a wallet-app-less participant using the printed QR credential issued by the cashier + a PIN, and also already charges an app-holding participant via dynamic QR/NFC, approved from the participant's phone. Operational sessions (opening/closing a terminal), multi-item orders, and refunds don't exist yet — this page will grow once those endpoints exist. :::

PDV is an operational account (operator_type=pdv), created by management and scoped to a specific workspace. See Management → Operators (PDV and cashier) for how the account is provisioned.

What exists today

• Login/logout/refresh (see Authentication).
• Charge a wallet-app-less participant via a printed QR + PIN issued by the cashier (see Payment via printed QR + PIN).
• Charge an app-holding participant via dynamic QR/NFC, approved from their phone (see Dynamic payment via QR/NFC).
• Check the history of the PDV's own sales/attempts, both methods together (see My sales).

Where everything lives

• Authentication — login, refresh, logout, what the PDV JWT contains.
• Payment via printed QR + PIN — charging a wallet-app-less participant.
• Dynamic payment via QR/NFC — charging an app-holding participant, with real-time notification over a WebSocket.
• My sales — unified history of approved, declined and expired sales.

Planned (not implemented yet)

• Terminal operational session (open/close).
• Multi-item order and payment intent creation.
• Full/partial refund of a charge.