Overview

Proper error handling is essential, as it ensures that your application can gracefully manage unexpected situations, provide meaningful feedback to users, and maintain system stability while protecting sensitive data.

When an error occurs, you'll receive an error code (SDKXXXX) and descriptive error message.

Error codes

The following table describes all the possible SDK errors codes.

Error code	Description	Suggested action
`SDK0001`	An unknown error has occurred.	Log the error and contact support if recurring.
`SDK0002`	Network connectivity issue occurred.	Check your internet connection and retry.
`SDK0003`	Network operation attempted on the main thread.	Ensure network operations run off the main thread.
`SDK0004`	Request sent successfully from SDK to POS, but read/write data timed out.	Check the transaction status. Log the event for tracking and reach out to support if this occurs frequently. The auto-reversal should be handled by POS.
`SDK0005`	Failed to connect.	Verify the server address and network, then attempt to reconnect.
`SDK0006`	Illegal arguments.	Please check the arguments.
`SDK0007`	Invalid parameters.	Please check the parameters.