GitHub Start free

What does storeProblemError (code 2) mean in the purchases SDK?

The purchases SDK raises storeProblemError (code 2) when the App Store or Google Play fails a request or the backend reports a store problem.

Quick facts#
Error ErrorCode.storeProblemError (iOS), PurchasesErrorCode.StoreProblemError (Android), code 2
Where Purchases SDK (iOS, Android and the hybrid SDKs built on them)
What the vendor says There was a problem with the store.

Cause#

  • StoreKit 2: StoreKitError.systemError, .notEntitled and .unknown, and Product.PurchaseError.invalidQuantity all map here.
  • Android: Play Billing ERROR, SERVICE_UNAVAILABLE, SERVICE_DISCONNECTED and SERVICE_TIMEOUT map here. Google describes ERROR as an internal Play problem and SERVICE_DISCONNECTED as a severed connection (Google docs).
  • The backend answered 7101 (store problem), or on Android 7229 (Play quota exceeded) or 7231 (Play generic error).

Fix#

  1. Read the underlying error: NSUnderlyingErrorKey and rc_backend_error_code on iOS, underlyingErrorMessage on Android. They tell a StoreKit failure from a backend 7101.
  2. Retry once after a short pause. Google recommends retries with backoff for ERROR and service disconnects.
  3. Check that the store account on the device works: open the App Store or Google Play once and try again.
  4. If the backend sent 7101, fix the store key or service account the message names, using Verify credentials on the app page.

Example#

Swift
// The purchases SDK throws `ErrorCode` values; match the one you handle and let the rest fall through.
func handle(_ error: Error) {
    guard let code = error as? ErrorCode else {
        print("Not a purchases SDK error: \(error)")
        return
    }
    switch code {
    case .storeProblemError:
        // Retrying once is reasonable; never unlock until customer info shows the entitlement.
        print("The store had a problem; read the underlying error")
    default:
        print("Other purchases error: \(code.description)")
    }
}

Compile-checked: npm run check:snippets type-checks this snippet with swiftc together with the ErrorCode.swift file of the RevenueDot purchases-ios fork (checked 2026-10-03).

How the RevenueDot SDK reports it#

A burst of storeProblemError usually means a store outage or a broken store credential on the server. See the server error codes for 7101. Deep dive: revenuedot.app/errors/store-problem-error.

Source#

Checked: 2026-10-03

Edit this page on GitHub ↗ View as Markdown Last updated