Skip to main content

ADVANCED

How to detect iOS Storefront?

When distributing your app through Apple's App Store, you may need to detect the current storefront to implement region-specific functionality. The storefront represents the App Store region that the user is currently using, identified by a three-letter country code (e.g., "USA" for United States).

This detection is particularly important because several storefronts now permit developers to direct players to external payment pages — the United States (Epic v. Apple), Japan (Mobile Software Competition Act), Brazil (CADE settlement), and the European Union (Digital Markets Act). You can use the storefront detection to:

  • Enable external payment links for the storefronts that permit them
  • Implement region-specific payment flows
  • Control feature availability based on regional requirements
  • Ensure compliance with local regulations
note

Apple's requirements differ per storefront. Japan, Brazil and the EU need an Apple entitlement and require you to report the resulting transactions back to Apple, while the United States storefront currently needs neither. The EU storefronts are left out of the snippet below; add the ones you ship to. See Reporting External Purchases to Apple before enabling external payments in a new market.

note

If the app is installed via alternative distribution (for example, an alternative marketplace/web distribution under the DMA), the Storefront country code may be unavailable and returned as an empty string. In that case, use the alternative store installation detection guide to determine whether the app is running in an alternative distribution environment.

To determine the current iOS storefront and control SDK functionality based on the region, use the following code snippets:

[SKPaymentQueue loadCurrentStorefrontCountryCodeWithCompletion:^(NSString* _Nullable countryCode) {
    // Storefronts where Apple permits external payments. Add EU codes if you ship there.
    NSSet<NSString*>* externalPaymentStorefronts = [NSSet setWithObjects:@"USA", @"JPN", @"BRA", nil];
    settings.enablePayments = countryCode && [externalPaymentStorefronts containsObject:countryCode];
    
    [[SKPaymentQueue defaultQueue] startWithSettings:settings];
}];

The loadCurrentStorefrontCountryCode method asynchronously retrieves the three-letter country code for the current Storefront. You can use this information to enable or disable SDK functionality for specific regions.

Alternatively, you can use Apple's Storefront ↗ (https://developer.apple.com/documentation/storekit/storefront) class directly, as demonstrated below:

note

We recommend against using the Objective-C SKStorefront implementation as it performs synchronous loading that blocks the main thread. This can lead to UI freezes and poor user experience, as noted in Apple's official documentation ↗.

let storefront = await Storefront.current   
let countryCode = storefront?.countryCode

settings.enablePayments = countryCode == "USA"
    
SKPaymentQueue.default().start(settings)

For more information, see the implementation in Apple's official documentation ↗ (https://developer.apple.com/documentation/storekit/skpaymentqueue/storefront).