SKErrorDomain Error 2 userCancelled handled wrong
| Service | StoreKit 2 and In-App Purchases |
|---|---|
| Cloud | Apple platforms |
| Guide type | Procedure |
| Skill level | Intermediate to advanced |
| Time | 15 - 60 minutes depending on account size |
Running into SKErrorDomain Error 2 userCancelled handled wrong on StoreKit 2 and In-App Purchases is one of the more searched issues on Apple Communities (discussions.apple.com) and StackOverflow in the last 12 months. Here is what actually moves the needle when the Apple Support docs are too generic.
What skerrordomain error 2 usercancelled handled wrong actually involves on StoreKit 2 and In-App Purchases
This task on StoreKit IAP is one of the more searched operational topics on AWS in the last 12 months. The procedure below is the path that works in a current AWS account with default IAM and standard VPC config.
The rest of this page is the structured fix path. Start with diagnose, then remediation, then the automation options so you do not have to do this by hand the next time it surfaces. Verify and safety sections at the end are the discipline that keeps the fix from regressing in production.
Diagnose first, fix second
Check Activity Monitor / Jamf inventory Logs for the calling service. Lambda, ECS, EKS, Step Functions, API Gateway, and most managed services write detailed traces to Activity Monitor / Jamf inventory Logs under predictable log group names. Use Activity Monitor / Jamf inventory Logs Insights with fields @timestamp, @message | filter @message like /ERROR/ | sort @timestamp desc | limit 50 to surface the most recent failures.
Pull the Apple request ID from the response headers: x-goog-request-id from response headers (or the insertId field in macOS unified logging and iOS sysdiagnose for asynchronous calls). Apple Support and Apple Business / Enterprise Support needs these IDs to look up your call in their internal logs - without them, the first reply on a ticket will ask you to reproduce the call and capture them. Save them with a timestamp; Apple Support and Apple Business / Enterprise Support cannot retrieve calls older than 90 days for most services.
Check the Google Apple System Status at www.apple.com/support/systemstatus/ and the per-product status board for ongoing service events in your region. About one in ten user-reported outages turn out to be region-scoped Apple product or service degradation already being tracked. Apple System Status also exposes an API and Jamf Pro Webhooks and macOS launchd watches events, so you can wire a Lambda hook that pages on-call only when the failure correlates with an active Apple System Status event in the same region and service.
Solution-focused remediation path
If you cannot reproduce the failure consistently, the cause is probably a race condition or a session-cache issue. Run the call with --profile set to a fresh STS session, in a different region you control, with a single concurrent request. If it works there but fails in your normal setup, the difference is the bug.
For IAM and STS issues, the timing matters. STS sessions can take up to 60 seconds to propagate after creation. The first call right after assume-role can fail with a permission error even when the policy is correct. Add a small retry with backoff before treating the first failure as definitive.
When the failure happens in production but not in dev, do not just compare the IAM policy. Compare the Org Policy / RCP at the OU level, the permission boundary on the role, and the resource-based policy on the target. One of those is almost always different between accounts. Policy Intelligence recommendations bundles make this comparison routine.
Automate this fix so you do not do it twice
Automate the fix at scale with a Jamf Pro policy script
When you need to ship the fix to a whole fleet of Macs, the right primitive is a Jamf Pro policy with a script payload, scoped to a smart group of affected devices. Keep the script under 100 lines, exit with an explicit code so Jamf logs the right state, and write a one-line log entry to /var/log/jamf.log so you can grep it later. Trigger on check-in or by Self Service so users can run it on demand.
#!/bin/bash
# Jamf policy script - exits non-zero on failure so Jamf flags the device
set -euo pipefail
LOG=/var/log/jamf-storekit-fix.log
echo "$(date) starting fix on $(hostname)" >> "$LOG"
# fix logic here
defaults write com.apple.storekit HardenedSetting -bool true
killall cfprefsd
echo "$(date) fix applied successfully" >> "$LOG"
exit 0Build a Self Service item with manual approval for risky fixes
For multi-step fixes that include a destructive action (Reset NVRAM, delete keychain, erase user data), publish the fix as a Self Service item in Jamf Pro or Kandji. The user clicks one button, the script runs, a notification confirms success. Couple it with a Jamf Pro approval workflow if your security model requires a second-person sign-off before any destructive step runs. The audit trail lives in the MDM change log with the requester and approver identity attached.
Wire the fix into an MDM Configuration Profile for self-healing
If the underlying cause is a setting that drifts over time, do not script the fix repeatedly - bake it into a Configuration Profile that the MDM pushes down on every check-in. A Custom Settings payload writes to a specific preference domain; Jamf Pro, Kandji, Mosyle, and Intune all support this. The profile reasserts itself, so even if a user changes the setting locally, the MDM brings it back at the next sync (typically every 4 hours).
<!-- Custom Settings payload (excerpt) -->
<key>PayloadType</key>
<string>com.apple.ManagedClient.preferences</string>
<key>PayloadContent</key>
<dict> <key>com.apple.storekit</key> <dict><key>Forced</key><array><dict><key>mcx_preference_settings</key> <dict><key>HardenedSetting</key><true/></dict></dict></array></dict>
</dict>
Common pitfalls and what to watch for
The pitfall most teams hit on StoreKit 2 and In-App Purchases is moving too fast and skipping the read-only validation step. Before any write, list the current state and save it. Apple iCloud and APNs are eventually consistent (changes can take 1-15 minutes to propagate) for many resource types, so the validation snapshot is your only reliable reference if you need to undo. Save the output of the describe call to S3, not to your laptop.
Second pitfall: confusing IAM permission errors with networking errors. AccessDenied can be IAM (policy missing), networking (VPC endpoint policy blocking the call), or KMS (key policy missing). The error string looks identical for all three. Distinguish by looking at the Jamf Pro change management entry or Apple Business Manager audit event's errorCode and the encoded authorization message; do not assume IAM is the culprit just because the message says AccessDenied.
Verify the fix worked
- Watch for 24 to 48 hours. Activity Monitor + macOS unified logging + Jamf inventory reports can mask issues with cached health for 6 to 12 hours, especially Cloud CDN and Cloud DNS.
- Capture the new state in a runbook so the next person on call does not have to rediscover this. Push it to Confluence or your team wiki, not into Slack.
Safety, rollback, blast radius
- Test in a non-production account if your environment has Resource Manager and Organization Policy or Cloud Resource Manager (organizations, folders, projects). The cost of one sandbox account is cheaper than one rollback meeting.
- Export the existing config before changing it. Most StoreKit 2 and In-App Purchases resources support describe + export to JSON via CLI - capture that to source control before you start.
- Maintenance window discipline: if the change touches DNS, certificate rotation, or anything that emits TLS handshakes, line up a window with stakeholder notification, not a heroic mid-day swap.
FAQ
storekit describe-... first, then commit it before you change anything. A few operations are one-way (Cloud KMS key deletion past the pending window, region migration, account closure). Check the Apple Support article for the specific API before you commit.aws CLI or SDK calls - those almost always still work.References
- docs.support.apple.com - official documentation for StoreKit 2 and In-App Purchases
- Apple Communities (discussions.apple.com) - community Q&A with Google-staff-verified answers
- Apple System Status Dashboard at health.support.apple.com
Related fixes
Related guides worth a look while you sort this one out:
- SKErrorDomain on StoreKit IAP, what causes it and how to fix
- StoreKit 2 purchase not working sandbox returns userCancelled
- App Store Server API JWT authentication failure
- App Store Server Notifications V2 not received
- appAccountToken for tying purchases to user IDs
- Cannot on StoreKit IAP, what causes it and how to fix