Common Errors and Codes in IZI
Common Errors and Codes in IZI
Section titled “Common Errors and Codes in IZI”Authorization and Access Errors
Section titled “Authorization and Access Errors”| Code / message | Cause | Fix |
|---|---|---|
| 401 Unauthorized | Session expired or invalid token | Log out and back into CRM |
| 403 Forbidden | No rights for the action | Check role in Settings → Staff |
| ”Invalid login or password” | Typo or password changed | Check caps lock; use email password reset if forgotten |
| ”Account blocked” | Too many failed attempts or manual block | Contact your organization’s administrator |
Agent and PC Errors
Section titled “Agent and PC Errors”| Code / message | Cause | Fix |
|---|---|---|
| ”Agent not found” | Agent not running or not installed | Launch agent on the PC or reinstall it |
| ”Agent connection timeout” | Network between agent and server interrupted | Check internet on PC, restart agent |
| ”PC offline” | Agent hasn’t responded for N seconds | Recovery instructions |
| ”Invalid agent version” | Agent version is outdated | Update agent via Settings → Equipment |
| ”License expired” | PC license has expired | Contact IZI support |
Session Errors
Section titled “Session Errors”| Code / message | Cause | Fix |
|---|---|---|
| ”Session already active” | Session already running on this PC | End the active session, then start a new one |
| ”Insufficient balance” | Client’s balance can’t cover the tariff | Top up balance or choose a lower-cost tariff |
| ”Session stuck” | Agent lost connection mid-session | Force end instructions |
| ”Tariff not available” | Tariff deactivated or not assigned to the PC | Check tariff settings in the Tariffs section |
Payment Errors
Section titled “Payment Errors”| Code / message | Cause | Fix |
|---|---|---|
| ”Payment declined” | Bank rejected the payment | Try another card or cash |
| ”Terminal unavailable” | Terminal not responding | Terminal diagnostics |
| ”Transaction timeout” | Client or cashier didn’t complete operation in time | Restart the payment |
| ”Duplicate transaction” | Repeated payment with same parameters | Wait 5 minutes or change amount; contact support if refund needed |
| ”CloudPayments error 5” | Insufficient funds on card | Another card or different payment method |
Shift Errors
Section titled “Shift Errors”| Code / message | Cause | Fix |
|---|---|---|
| ”Active sessions exist” | Can’t close shift with active sessions | End all sessions |
| ”Pending transactions” | Unfinished transactions present | Wait or cancel stuck transactions |
| ”Shift already closed” | Shift already closed by another administrator | Check Finance → Shift History |
Network and Server Errors
Section titled “Network and Server Errors”| Code / message | Cause | Fix |
|---|---|---|
| 500 Internal Server Error | Error on the IZI server | Wait 1–2 minutes and retry; if persistent — contact support |
| 503 Service Unavailable | Server temporarily unavailable (maintenance) | Wait and retry |
| ”No internet connection” | CRM device lost network | Check internet on your computer |
| ”SSL certificate error” | Security certificate issue | Update your browser; if that doesn’t help — contact support |
Error Not in the Table
Section titled “Error Not in the Table”- Copy the exact error text from the screen
- Note the time and action that triggered the error
- Contact IZI support — provide the error text and steps to reproduce
Frequently asked questions
Where can I view the full error log in IZI?
Settings → Event Log. It shows recent system events with timestamps. For issues with a specific PC — PC card in the Hall section → History tab.
Error 403 — what does it mean?
No access rights. Either the user's role doesn't include the required action, or the auth session expired. Log out and back in; if that doesn't help — check roles in Settings → Staff.
Agent not found error appears every morning — why?
The agent isn't set to start automatically with Windows. Add IZI Agent to startup: Win+R → shell:startup → create a shortcut to the agent in the folder that opens.
Connection error after changing internet provider — what to do?
After changing providers or router settings, the IP or DNS may have changed. Restart the agent on all PCs. If that doesn't help — check whether the new router is blocking any ports.