SDK API Interaction Errors

Here you can find the descriptions of errors that may be returned from SDK while interacting with the Qonversion backend. These descriptions are intended to help you troubleshoot any issues quicker.

🚧

Make sure to use a device (not a simulator) when testing iOS purchases.

iOS Errors Codes

Qonversion SDK provides error codes that help locate and eliminate possible issues. Most Qonversion errors for iOS correspond to StoreKit SKError objects. You can check the errors described in the table below in QNErrors.h file.

Android Errors Codes

You can use both physical devices and emulators to test Android in-app purchases.
Qonversion SDK provides error codes that help locate and eliminate possible issues. The table below contains the descriptions of the possible errors.

📘

Error additional message

The field QonversionError.additionalMessage contains the detailed error information. If you see the following message: It is a proxy of the Google BillingClient error, please check Google's documentation on BillingClient.

Here is an example of how you can get the error details including additional error information, error code, and description:

Qonversion.getSharedInstance().products(new QonversionProductsCallback() {
    @Override
    public void onSuccess(@NotNull Map<String, QProduct> productsList) {
        // handle available products here
    }

    @Override
    public void onError(@NotNull QonversionError error) {
        // Additional error information (if possible)
        String additionalErrorMessage = error.getAdditionalMessage();
        // Error enum code
        QonversionErrorCode errorCode = error.getCode();   
        // Error enum code description
        String errorDescription = error.getDescription();             
        // Handle the error
    }
});

Qonversion.shared.products(object : QonversionProductsCallback {
    override fun onSuccess(products: Map<String, QProduct>) {
        // handle available products here
    }
    override fun onError(error: QonversionError) {
        // Additional error information (if possible)
        val additionalErrorMessage = error.additionalMessage 
        // Error enum code
        val errorCode = error.code 
        // Error enum code description
        val errorDescription = error.description 
        // Handle the error 
    }
})

Each Qonversion callback has the fun onError(error: QonversionError) where error information is available.