Common Errors and Codes in IZI

Common Errors and Codes in IZI

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

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

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

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

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

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

1. Copy the exact error text from the screen
2. Note the time and action that triggered the error
3. Contact IZI support — provide the error text and steps to reproduce