POS terminal troubleshooting
Goal
Unblock register configuration and first-sale failures tied to terminals.
Who it is for
Clerk and manager.
Common problems
| Symptom | Likely cause | What to do |
|---|---|---|
| No active registers are available | No active terminals | Create/activate a terminal |
| Terminal … is inactive | is_active false | Edit terminal → Active |
| Device pending trust | Binding trusted_devices | Approve device under POS Devices |
| Cannot open session | Session already open / missing pos.manage_sessions | Close existing session or grant permission |
| Stock ops unavailable | Terminal without warehouse | Set Warehouse on the terminal |
| Payment method missing on Charge | Method not in allowed_payment_methods or disabled | Edit payment methods on the terminal |
| 422 on save | Code/name/warehouse/cash validation | Fix required fields and enum values |