Handle errors in Kotlin Multiplatform SDK

This page covers error handling in the Adapty Kotlin Multiplatform SDK.

Error handling basics

All Adapty SDK methods return results that can be either success or error. Always handle both cases:

Adapty.getProfile { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val profile = result.value
            // Handle success
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // Handle error
            Log.e("Adapty", "Error: ${error.message}")
        }
    }
}

Adapty.getProfile(result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyProfile profile = ((AdaptyResult.Success<AdaptyProfile>) result).getValue();
        // Handle success
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // Handle error
        Log.e("Adapty", "Error: " + error.getMessage());
    }
});

Common error codes

AdaptyError.code is an AdaptyErrorCode enum value, not a number — compare it against the enum constant, not against the numeric code. The numbers below are shown only because they are what a log line or a support ticket usually carries.

Error code	Number	Description	Solution
`AdaptyErrorCode.NO_PRODUCT_IDS_FOUND`	1000	None of the products in the paywall are available in the store.	See Fix for Code-1000 noProductIDsFound error.
`AdaptyErrorCode.CANT_MAKE_PAYMENTS`	1003	In-app purchases are not allowed on this device.	See Fix for Code-1003 cantMakePayments error.
`AdaptyErrorCode.PRODUCT_NOT_FOUND`	22	The product requested for purchase is not available in the store.	Check that the product is configured in the store and in the Adapty Dashboard.
`AdaptyErrorCode.NETWORK_FAILED`	2005	The network request failed.	Ask the user to check their connection, or retry the call.
`AdaptyErrorCode.ADAPTY_NOT_INITIALIZED`	20	The SDK was not activated before the call.	Wait for `Adapty.activate` to complete before any other SDK call.

For the full list of codes, see AdaptyErrorCode in the SDK models reference.

Handle specific errors

Network errors

Adapty.getPaywall("main") { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val paywall = result.value
            // Use paywall
        }
        is AdaptyResult.Error -> {
            val error = result.error
            when (error.code) {
                AdaptyErrorCode.NETWORK_FAILED -> {
                    // Network error - show offline message
                    showOfflineMessage()
                }
                else -> {
                    // Other errors
                    showErrorMessage(error.message)
                }
            }
        }
    }
}

Adapty.getPaywall("main", result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyPaywall paywall = ((AdaptyResult.Success<AdaptyPaywall>) result).getValue();
        // Use paywall
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        switch (error.getCode()) {
            case NETWORK_FAILED:
                // Network error - show offline message
                showOfflineMessage();
                break;
            default:
                // Other errors
                showErrorMessage(error.getMessage());
                break;
        }
    }
});

Purchase errors

product.makePurchase { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val purchase = result.value
            // Purchase successful
            showSuccessMessage()
        }
        is AdaptyResult.Error -> {
            val error = result.error
            when (error.code) {
                AdaptyErrorCode.CANT_MAKE_PAYMENTS -> {
                    // Can't make payments
                    showPaymentNotAvailableMessage()
                }
                AdaptyErrorCode.PRODUCT_NOT_FOUND -> {
                    // Product not available
                    showProductNotAvailableMessage()
                }
                else -> {
                    // Other purchase errors
                    showPurchaseErrorMessage(error.message)
                }
            }
        }
    }
}

product.makePurchase(result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyPurchase purchase = ((AdaptyResult.Success<AdaptyPurchase>) result).getValue();
        // Purchase successful
        showSuccessMessage();
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        switch (error.getCode()) {
            case CANT_MAKE_PAYMENTS:
                // Can't make payments
                showPaymentNotAvailableMessage();
                break;
            case PRODUCT_NOT_FOUND:
                // Product not available
                showProductNotAvailableMessage();
                break;
            default:
                // Other purchase errors
                showPurchaseErrorMessage(error.getMessage());
                break;
        }
    }
});

Error recovery strategies

Retry on network errors

fun getPaywallWithRetry(placementId: String, maxRetries: Int = 3) {
    var retryCount = 0
    
    fun attemptGetPaywall() {
        Adapty.getPaywall(placementId) { result ->
            when (result) {
                is AdaptyResult.Success -> {
                    val paywall = result.value
                    // Use paywall
                }
                is AdaptyResult.Error -> {
                    val error = result.error
                    if (error.code == AdaptyErrorCode.NETWORK_FAILED && retryCount < maxRetries) {
                        // Network error - retry
                        retryCount++
                        Handler(Looper.getMainLooper()).postDelayed({
                            attemptGetPaywall()
                        }, 1000 * retryCount) // Exponential backoff
                    } else {
                        // Max retries reached or other error
                        showErrorMessage(error.message)
                    }
                }
            }
        }
    }
    
    attemptGetPaywall()
}

public void getPaywallWithRetry(String placementId, int maxRetries) {
    AtomicInteger retryCount = new AtomicInteger(0);
    
    Runnable attemptGetPaywall = new Runnable() {
        @Override
        public void run() {
            Adapty.getPaywall(placementId, result -> {
                if (result instanceof AdaptyResult.Success) {
                    AdaptyPaywall paywall = ((AdaptyResult.Success<AdaptyPaywall>) result).getValue();
                    // Use paywall
                } else if (result instanceof AdaptyResult.Error) {
                    AdaptyError error = ((AdaptyResult.Error) result).getError();
                    if (error.getCode() == AdaptyErrorCode.NETWORK_FAILED && retryCount.get() < maxRetries) {
                        // Network error - retry
                        retryCount.incrementAndGet();
                        new Handler(Looper.getMainLooper()).postDelayed(this, 1000 * retryCount.get());
                    } else {
                        // Max retries reached or other error
                        showErrorMessage(error.getMessage());
                    }
                }
            });
        }
    };
    
    attemptGetPaywall.run();
}

Fallback to cached data

class PaywallManager {
    private var cachedPaywall: AdaptyPaywall? = null
    
    fun getPaywall(placementId: String) {
        Adapty.getPaywall(placementId) { result ->
            when (result) {
                is AdaptyResult.Success -> {
                    val paywall = result.value
                    cachedPaywall = paywall
                    showPaywall(paywall)
                }
                is AdaptyResult.Error -> {
                    val error = result.error
                    if (error.code == AdaptyErrorCode.NETWORK_FAILED && cachedPaywall != null) {
                        // Network error - use cached paywall
                        showPaywall(cachedPaywall!!)
                        showOfflineIndicator()
                    } else {
                        // No cache available or other error
                        showErrorMessage(error.message)
                    }
                }
            }
        }
    }
}

public class PaywallManager {
    private AdaptyPaywall cachedPaywall;
    
    public void getPaywall(String placementId) {
        Adapty.getPaywall(placementId, result -> {
            if (result instanceof AdaptyResult.Success) {
                AdaptyPaywall paywall = ((AdaptyResult.Success<AdaptyPaywall>) result).getValue();
                cachedPaywall = paywall;
                showPaywall(paywall);
            } else if (result instanceof AdaptyResult.Error) {
                AdaptyError error = ((AdaptyResult.Error) result).getError();
                if (error.getCode() == AdaptyErrorCode.NETWORK_FAILED && cachedPaywall != null) {
                    // Network error - use cached paywall
                    showPaywall(cachedPaywall);
                    showOfflineIndicator();
                } else {
                    // No cache available or other error
                    showErrorMessage(error.getMessage());
                }
            }
        });
    }
}

Next steps

Fix for Code-1000 noProductIDsFound error
Fix for Code-1003 cantMakePayments error
Complete API reference - Full SDK documentation