Skip to main content

​
Overview

Now that you’ve set up placements, choose the subscription product Encore offers. When a user accepts a win-back offer, Encore triggers a real App Store subscription purchase using the product you select here. The App Store handles all entitlement state — no custom entitlement tracking code is needed in your app. The fastest path is to connect your App Store Connect catalog so Encore auto-syncs your subscriptions and you pick one from a dropdown — no typing Product IDs by hand. This happens in the Entitlements step (labelled Connect store) of the Integration Progress tracker.
Connect your App Store Connect API key once, then pick your subscription from the auto-synced list. Manual Product ID entry is still available as a fallback if you don’t connect a credential.
1

Upload your App Store Connect API key

In your app’s Entitlements step, upload an App Store Connect API key (Key ID, Issuer ID, and .p8 file). Encore verifies it with Apple, then pulls your subscription catalog.See Connect Your Store Credentials for the full walkthrough, including the App Manager role requirement and where to find each value.
2

Pick your subscription product

Once the catalog syncs, the Subscription product section shows a picker. Choose the product that gates entitlements — Encore reads its price and intro-offer details automatically, so there’s nothing else to type.
3

Don't have a product yet? Let Encore create one

If you don’t already have a suitable subscription, Encore can pre-fill a recommended annual product (priced from your existing catalog, with a free trial) and create it in App Store Connect for you. Review the auto-filled fields, confirm, and Encore writes the product as a draft — promote it to ACTIVE in App Store Connect when you’re ready.
Newly created products land in your App Store Connect catalog as a draft. Review the auto-filled display name, price tier, and introductory offer, then promote to ACTIVE before users can purchase.

​
Manual Product ID Entry (Fallback)

If you haven’t connected a store credential, you can still enter a Product ID by hand. Create the subscription yourself in App Store Connect, then enter its ID in the Encore Dashboard.
1

Create the subscription in App Store Connect

Go to appstoreconnect.apple.com → Your App → Subscriptions.Create a subscription group if you don’t have one, add the subscription, set its duration and availability, then add a Free introductory offer. Save and submit for review.
Subscriptions can be approved independently of app updates.
2

Enter the Product ID in Encore

In your app’s Entitlements step, type the Product ID (e.g. com.yourapp.encore.annual.1m.trial) into the fallback input and save.

​
What the SDK does with this Product ID at runtime

You never hard-code the Product ID in your app — Encore delivers it to the SDK as remote configuration:
  • The SDK fetches your app’s config (including the configured subscription Product ID) on configure() and again on each identify().
  • That config is disk-cached, so it’s available immediately on cold start; the SDK refreshes it in the background on the next launch. The very first launch (before the first fetch completes) is the only time the Product ID may be momentarily unavailable.
  • When a user accepts an offer, the SDK uses the configured Product ID to start the App Store purchase — either via native StoreKit (no onPurchaseRequest handler set) or by passing it to your handler as purchaseRequest.productId.
Because it’s remote config, changing the product in the Encore Dashboard takes effect without an app update.

​
Next Steps