Apple's External Link Account Entitlement: Technical Setup and the 27% Commission Process

The `apple external link account entitlement` allows specific US-based iOS apps to direct users to an external website for purchases or account registration, bypassing Apple's standard in-app purchase flow. This entitlement offers a 27% commission rate on external transactions, contrasting with the standard 30% or 15% for In-App Purchases. Implementing this system requires a precise technical setup, detailed transaction reporting, and an understanding of the user experience.

What is the StoreKit External Link Account Entitlement?

This entitlement, available for certain app types in the US App Store, allows developers to embed an in-app link to an external website. On this website, users can complete a purchase or manage their account for digital content or subscriptions. This primarily applies to "reader" apps, such as those for music, video, books, news, or magazines, and other apps offering digital content consumed outside the app itself. The key distinction is that payment processing occurs directly on the developer's external website. This system provides an alternative to Apple's In-App Purchase (IAP) system for eligible app categories. Apple charges a 27% commission on all transactions completed externally when initiated from the external link within your app. This rate differs from the standard 30% commission on IAP transactions, or the 15% rate for developers participating in the Small Business Program.

Applying for the Entitlement and App Store Connect Setup

Before implementing any code, you must apply for and receive approval for the entitlement from Apple. This manual review process requires specific information about your app and its planned external purchase flow.

1. Request the Entitlement: Submit a formal request for the StoreKit External Link Account Entitlement through Apple's dedicated form at developer.apple.com/contact/request/storekit-external-link-account-entitlement/. Provide your app's bundle ID, the exact website URL for external purchases, and a description of your entitlement usage.
2. Receive Approval: Apple reviews your request, a process that can take several business days. Upon approval, the `com.apple.developer.storekit.external-link-account` entitlement is added to your developer account.
3. Configure Associated Domains: In App Store Connect, link your app to the specific domain(s) on your website where users will complete purchases. Navigate to your app, then App Store > App Information > General Information > External Purchases to specify these domains. Your website must host an `apple-app-site-association` file containing the entitlement details, similar to Universal Links.
4. Add Entitlement to Xcode Project: In Xcode, add the `com.apple.developer.storekit.external-link-account` entitlement directly to your app's `.entitlements` file. This action authorizes your app to use the external link functionality.

Without completing these steps, your app cannot use the `SKExternalLinkAccount` API. Attempts to open external links via this method will fail, or the app will face rejection during App Store Review.

Implementing the External Link in Your App

Once your entitlement is approved and configured, use the `StoreKit` framework to implement the external link. This involves a specific API that informs the user about navigating outside the App Store's purchasing environment.

1. Import StoreKit: Add import StoreKit to any Swift file where you plan to use the external link functionality.
2. Instantiate `SKExternalLinkAccount`: Create an instance of `SKExternalLinkAccount`. This object facilitates generating the transaction token and opening the external URL.
3. Generate the Transaction Token: Before directing the user to your external URL, your app must generate a `transactionToken`. This token is vital for Apple's audit process, as it uniquely identifies the user session that leads to a potential external purchase. Access it via the `SKExternalLinkAccount` instance:

   let externalLinkAccount = SKExternalLinkAccount()
   let transactionToken = await externalLinkAccount.transactionToken

   You must capture this `transactionToken` and associate it with any subsequent purchase the user makes on your external website. This is typically achieved by passing the token as a URL query parameter or an HTTP header to your web server.
4. Open the External URL: Use the `open(_:completionHandler:)` method of `SKExternalLinkAccount` to display the native warning sheet and then navigate the user to your configured URL.

   externalLinkAccount.open(url) { error in
       if let error = error {
           // Handle error, e.g., user cancelled or an issue occurred
           print("Failed to open external link: \(error.localizedDescription)")
       } else {
           // Link opened successfully, user is on your website
           print("External link opened successfully.")
       }
   }

   The `url` parameter must be one of the domains you configured in App Store Connect.

It is crucial to pass the `transactionToken` from your app to your backend system. This token serves as a unique identifier for Apple to reconcile external purchases with your submitted reports.

The 27% Commission Reporting Requirements

The 27% commission rate offers a reduction from the standard 30% IAP commission. However, this benefit comes with a significant compliance obligation: you must accurately report all transactions completed via your external link to Apple. The 27% commission applies to the gross value of all sales of digital goods and services made through your external link. Apple requires integration with their reporting mechanism to provide details of these transactions, including the `transactionToken` generated in your app. Failure to accurately report transactions or under-reporting can lead to severe consequences, including:

• Audits from Apple, requiring detailed sales records.
• Forced payment of unpaid commissions, potentially with interest.
• Removal of the entitlement or your app from the App Store.

Apple periodically audits reported sales against the `transactionToken` data they receive. Maintaining meticulous records and ensuring your backend correctly attributes each `transactionToken` to completed sales is essential. While there is no public API documentation for this reporting mechanism, specific instructions are communicated to developers upon entitlement approval.

User Experience: The Native Warning Sheet and Conversion Impact

When a user taps an external link button in your app, they do not immediately navigate to your website. Instead, Apple presents a native warning sheet requiring user confirmation. This sheet informs users that they are leaving the app and proceeding to an external website. It also states that purchases made outside the app are not subject to the App Store’s refund policies, and Apple is not responsible for the security or privacy of those transactions. This warning manages user expectations and delineates Apple's responsibility. For developers, it adds an extra step in the conversion funnel. Users must acknowledge and confirm they understand they are leaving the App Store's ecosystem. This additional friction point can impact conversion rates, as some users may hesitate or be confused by the warning. When designing your user interface, consider this warning. Your in-app button or call to action should clearly indicate that the user will be taken to an external website. For example, using labels like "Subscribe on our Website" or "Manage Account on [Your Brand].com" can help set expectations and reduce user surprise when the warning appears.

Worked Example: A Habit Tracker's External Subscription Flow

Consider a habit tracker app that offers a premium subscription for advanced features like unlimited habits and custom streaks. You decide to use the External Link Account Entitlement to process these subscriptions on your website. 1. **User Discovers Premium:** A user opens your habit tracker app and taps a "Go Premium" button to unlock advanced features. 2. **App Generates Token:** Your app, using `SKExternalLinkAccount`, generates a unique `transactionToken` (e.g., `XYZ123ABC`). It prepares to open your subscription URL, appending this token as a query parameter: `https://yourhabittracker.com/premium?token=XYZ123ABC`. 3. **Apple Warning Sheet:** The native warning sheet appears, informing the user about leaving the app. The user taps "Continue" to proceed. 4. **External Website Purchase:** The user is redirected to your website, where they sign up for the premium subscription using your chosen payment processor (e.g., Stripe). Your backend captures the `XYZ123ABC` token passed in the URL. 5. **Developer Reports Transaction:** Once the payment is successfully processed on your website, your backend system records the transaction, associates it with `XYZ123ABC`, and reports it to Apple's designated API. 6. **27% Commission:** Apple reviews your reported transaction, verifies it using the `transactionToken`, and applies a 27% commission on the subscription's gross value. This example illustrates both the additional user interaction and the critical backend work required for compliance and accurate commission calculation.

Checklist: Implementing the External Link Account Entitlement

To help navigate this process, here's a step-by-step checklist for implementing Apple's External Link Account Entitlement:

1. Review Eligibility: Confirm your app category (e.g., reader app) and target market (US App Store) are eligible for the entitlement.
2. Request Entitlement: Submit the formal request form to Apple via developer.apple.com/contact/request/storekit-external-link-account-entitlement/.
3. Receive Approval: Wait for Apple's approval and confirmation that the `com.apple.developer.storekit.external-link-account` entitlement has been granted to your developer account.
4. Configure App Store Connect: In App Store Connect, add the associated domain(s) for your external purchase website under App Store > App Information > General Information > External Purchases.
5. Prepare Your Website: Ensure your external purchase website is live, handles payments securely, and is configured to receive and store the `transactionToken` from your app.
6. Add Entitlement to Xcode: In your Xcode project, ensure the `com.apple.developer.storekit.external-link-account` entitlement is added to your app's .entitlements file.
7. Implement `StoreKit` API:
   • Import `StoreKit`.
   • Create an `SKExternalLinkAccount` instance.
   • Asynchronously obtain the `transactionToken` using `await externalLinkAccount.transactionToken`.
   • Call `externalLinkAccount.open(url) { error in ... }` to open your external URL, ensuring the `transactionToken` is passed to your website.
8. Integrate Backend Reporting: Implement a system on your backend to:
   • Capture the `transactionToken` with every external purchase initiated from the app.
   • Accurately record transaction details (value, date, product).
   • Report these transactions to Apple's designated API as per instructions provided upon entitlement approval.
9. Design User Experience: Clearly label your in-app links (e.g., "Manage on our Website") to prepare users for the native warning sheet.
10. Test Thoroughly: Test the entire flow from app tap to external purchase and backend reporting, verifying correct `transactionToken` passing and recording.
11. Prepare for Audits: Maintain detailed records of all external transactions and be ready to provide them to Apple upon request.

FAQ

Is the External Link Account Entitlement available for all apps and regions?

No, this entitlement is currently restricted to specific app categories, such as "reader" apps, and is only available for apps distributed in the US App Store. Apple's documentation specifies which app types qualify.

Can I use this entitlement for one-time purchases, or only subscriptions?

The entitlement covers both subscriptions and one-time purchases of digital content or services consumed outside the app. The key requirement is that the purchase occurs externally on your website, not through Apple's In-App Purchase system.

Does the 15% commission rate for the Small Business Program apply to external link purchases?

No. The 15% commission rate from the Small Business Program applies only to transactions processed through Apple's In-App Purchase system. External link purchases, if eligible and properly reported, are subject to a 27% commission, regardless of your app's enrollment in the Small Business Program.

What happens if I simply link to my external website without using the entitlement?

If your app links to an external website for purchasing digital content or subscriptions without using the approved entitlement, it will likely be rejected by App Store Review. Apple strictly enforces that all digital purchases for content consumed in the app must use IAP, or the approved external link entitlement where applicable.

Do I still need a privacy policy if I use external links for purchases?

Yes. Even if purchases are handled externally, your app collects data, and you remain responsible for user privacy. A comprehensive privacy policy is a fundamental requirement for any app on the App Store or Google Play. If you need assistance generating one, LaunchShots offers a free Privacy Policy Generator tool.

Complying with the External Link Account Entitlement

Implementing the External Link Account Entitlement requires attention to technical detail and ongoing compliance. While it offers a slightly lower commission rate, the operational overhead for development, reporting, and auditing needs careful consideration. LaunchShots provides tools like the free screenshot editor to help you create compelling visuals that accurately represent your app's experience, supporting clear communication in your App Store listing.