Android SDK Troubleshooting
Use this reference to resolve Android SDK errors. Errors marked with * require explicit handling in your app. For general error-handling guidance, see Handle SDK Errors in the Best Practices guide.
Backend Server Related Errors
| Error Code | Description | Resolution |
|---|---|---|
INVALID_API_KEY | The API key provided is invalid or has expired. | Update your app with a valid API key (critical). |
INVALID_USER_ID | The user_id parameter in ZSConfiguration is empty. | Ensure a valid user_id is provided when initialising the SDK. |
PLAN_INACTIVE_IN_ZSM | The selected plan is marked as inactive in Zoho Billing. | Activate the plan in Zoho Billing before allowing purchases. |
PURCHASE_ALREADY_PROCESSED* | The purchase is already synced to Zoho Billing. | Use your backend to verify the active subscription. (Applies to restorePurchase only.) |
UNKNOWN_SERVER_ERROR | An unknown error occurred on Zoho Billing server. | Show the error and prompt the user to contact support with ZSErrorCode details. |
STORE_CONNECTIVITY_ERROR | Connection problem between Zoho Billing and Play Store server. | Ask the user to retry after some time. (Applies to initiatePurchase, changePlan, restorePurchase.) |
Play Store Purchase Related Errors
| Error Code | Description | Resolution |
|---|---|---|
INAPP_PURCHASE_NOT_ALLOWED | In-app purchase is not allowed on this device. | Show the error; the user cannot complete the purchase on this device. |
ITEM_ALREADY_PURCHASED | The selected plan is already purchased by the user. | Inform the user that this plan is already active. |
ITEM_UNAVAILABLE_FOR_PURCHASE | The selected plan is not available in Play Store. | Check Play Store configuration for the Product ID. |
USER_CANCELED* | User pressed back button during the purchase dialog. | No error dialog needed; allow the user to retry. |
PLAY_STORE_PROBLEM* | An error occurred during Play Store purchase processing. | Allow the user to retry the purchase. |
DEVELOPER_ERROR | Invalid parameters passed to the Play Store purchase method. | Check SDK integration code for parameter errors. |
NO_PURCHASE_AVAILABLE* | No active purchases found in Play Store. | Show a user message; no purchases to restore. (Applies to restorePurchase only.) |
UNKNOWN_ERROR | An unknown error occurred with Play Store. | Show the error and allow the user to retry or contact support. |
Network Connection Related Errors
| Error Code | Description | Resolution |
|---|---|---|
NO_INTERNET_CONNECTION* | Device has no internet connection. | Prompt the user to restore connection and retry. |
NETWORK_ERROR* | A network connectivity issue occurred. | Ask the user to retry the operation. |
Note:
Errors marked with * should be handled explicitly in your app. For other errors, display a user-friendly message and prompt the user to contact your support team with the ZSErrorCode details (code and description).
Yes