What does purchaseCancelledError (code 1) mean in the purchases SDK?

The purchases SDK raises purchaseCancelledError (code 1) when the customer closes the purchase sheet without buying.

Quick facts#


Error	`ErrorCode.purchaseCancelledError` (iOS), `PurchasesErrorCode.PurchaseCancelledError` (Android), code 1
Where	Purchases SDK (iOS, Android and the hybrid SDKs built on them)
What the vendor says	Purchase was cancelled.

Cause#

StoreKit 2 reports StoreKitError.userCancelled and StoreKit 1 reports SKError.paymentCancelled; the SDK maps both to this error.
On Android, Play Billing returns USER_CANCELED when the customer leaves the billing flow, and the SDK maps it here (Google docs).
The Cancel button in the Test Store purchase dialog raises it too, so a tester can see it without leaving the app.

Fix#

Treat it as an outcome, not an error. In the Swift async API read userCancelled on the result; in callbacks read the userCancelled flag.
Leave the paywall open with its products loaded so the customer can choose again.
Count cancels apart from failures in analytics.
Turn on debug logs if a tester says they did not cancel; the underlying error shows who reported the cancel.

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 .purchaseCancelledError:
        // A cancel is the customer's choice: no dialog, no retry, nothing to unlock.
        print("Purchase cancelled")
    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#

RevenueDot never sees a cancelled purchase, because the SDK stops before it posts a receipt to POST /v1/receipts. Deep dive: revenuedot.app/errors/purchase-cancelled-error.

Source#

Checked: 2026-10-03

Edit this page on GitHub ↗ View as Markdown Last updated October 3, 2026