Apple App Store Promotional Offers

Learn how to configure App Store promotional offers

Offers in the App Store are special deals or discounts provided by these platforms for in-app purchases. For example, you can offer a user upfront payment for 6 months with a 40% discount, and after that user will pay the regular subscription price every month.

For Adapty to process offers from the App Store, you need to do the following:

  1. Create offers in the App Store Connect or create offers in the Google Play Console
  2. Create offers in Adapty
  3. Add these offers to a paywall in Adapty
  4. (only for iOS apps) Upload a special In-App Purchase Key from App Store Connect to Adapty.

The instructions on how to upload a special In-App Purchase Key from App Store Connect to Adapty are below.


  • Please note that you can use the same key for both In-app purchase API and promotional offers — there's no need to create a new one if you have access to the .p8 file you've previously generated.
  • To generate API keys for the App Store Server API, you need to have either an Admin role or an Account Holder role in App Store Connect. You can also read about how to generate API Keys in the Apple Developer Documentation.
  1. Open App Store Connect. Proceed to Users and AccessIntegrationsIn-App Purchase section.
  2. Then click the Plus (+) button next to the Active title. The Generate in-App Purchase Key window will open.
Generating new in-app purchase key
  1. Enter the name of the key for your future reference (this name is not used in Adapty).

  2. Click the Generate button. Once the Generate In-App Purchase Key window closes, you'll see the created key in the Active list.

    Generated in-app purchase key
  3. After generating your API key, click the Download In-App Purchase Key button to get the key as a file.
    Keep this file safe to later upload it to Adapty. Please keep in mind that the generated file can be downloaded only once, so store it safely until you upload it to Adapty. The generated .p8 key from the In-App Purchase section can be used for both In-app purchase API and promotional offers.

  4. Copy the value of the Key ID field from this screen as well.

  5. Open App Settings from Adapty top menu, then open the iOS SDK tab.

  6. Enter the value of the copied Key ID field to the Subscription key ID field next to the App Store promotional offers title.

  7. Upload the downloaded In-App Purchase Key file to the Subscription key (.p8 file) area .

After configuring the App Store promotional offer, you can create Apple promotional offers for specific products in Adapty if you did not do that yet. For more information, please refer to our promotional offers documentation.