This section provides guidance on integrating your mobile app, sold via the App Store, with Adapty. It involves inputting your app's configuration data from the App Store, essential for validating purchases and receiving subscription updates in Adapty. You can accomplish this during the initial onboarding or make adjustments later in the App Settings within the Adapty Dashboard.

Configure the integration in the Adapty Dashboard

Although you might have initially configured the integration of your mobile app and Adapty during onboarding, you can modify these settings later in the App settings.

❗️

Configuration change is only acceptable until you release your mobile app with integrated Adapty paywalls. The change after the release will break the integration and the paywalls will stop showing in your mobile app.

1. Open the App settings from the Adapty top menu.

   

2. In the iOS SDK tab of the App settings window, enter your mobile app Bundle ID, which is the unique identifier of your app in the App Store. This is required for the basic functionality of Adapty, such as subscription processing.

   How to find the Bundle ID of your mobile app in the App Store (Click to Expand)

   Open App Store Connect. Proceed to General → App Information section.
   The app ID is displayed in the Bundle ID field of the General Information sub-section.

   

3. Enter your mobile app's In-app purchase Issuer ID, referred to as Issuer ID in App Store Connect. This is a special ID that identifies the issuer who created the authentication token. Additionally, enter the In-App Purchase Key ID, referred to as Key ID in App Store Connect, which is a unique identifier associated with a cryptographic key you've generated in the Generate In-App Purchase Key in App Store Connect section.

   How to find the purchase issuer ID of your mobile app in the App Store (Click to Expand)

   1. Open App Store Connect. Proceed to Users and Access → Integrations → In-App Purchase section.

   2. In the Active list, find the key you've created in the Generate In-App Purchase Key in App Store Connect section.

   3. Use Issuer ID as In-app purchase Issuer ID, Key ID as In-app purchase Key ID and downloaded In-App Purchase Key for uploading to Adapty. Remember to store the key somewhere, as you can only download it once.

   

   4. Enter your mobile app In-app purchase Key ID, and upload the In-App Purchase Key file you have downloaded from App Store Connect in the Generate In-App Purchase Key in App Store Connect section.

   

4. Enter your mobile app App Store shared secret, also known as the App Store Connect Shared Secret, which is a 32-character hexadecimal string. It is used for in-app purchases and subscription receipt validation.

   How to find the shared secret of your mobile app in the App Store (Click to Expand)

   1. Open App Store Connect. Proceed to General → App Information section.
   2. Scroll down to the App-Specific Shared Secret sub-section.
      If the App-Specific Shared Secret sub-section is absent, make sure you have an Account Holder or Admin role. If you have an Admin role and yet cannot see the App-Specific Shared Secret sub-section, ask the Account Holder of the app (the person who has created the application in the App Store Connect) to generate the App Store shared secret for the app. After that, the sub-section will be shown to Admins as well.
   3. Click the Manage button. The App-Specific Shared Secret dialog opens.

   

   4. Copy the contents of the Shared Secret field and enter it into the App Store shared secret field in Adapty. If no shared secret is visible, click the Manage button in the App-Specific Shared Secret dialog.
   5. Click the Done button in the App-Specific Shared Secret dialog of App Store Connect to close it.

5. Copy the contents of the URL for App Store server notification field in Adapty.

   

6. Enter it into fields Production Server URL and Sandbox Server URL in the App Store Connect, General → App Information section, App Store Server Notifications subsection.

7. Click the Save button to confirm the changes.

Configure the integration in the onboarding

If you don't sell via the App Store, you can skip this step and proceed with adding your app on Android. However, if you do sell via the App Store, you can also skip this step for now. Keep in mind that this data is crucial for the basic functionality of Adapty, so you'll need to add it later. Once you've completed the onboarding process, you can enter the application store configuration in App Settings.

To add the configuration data of your app from the App Store:

1. Enter your mobile app's Bundle ID, which is the unique identifier of your app in the App Store. The bundle ID is essential for the basic functionality of Adapty, such as subscription processing.

   How to find the bundle ID of your mobile app in the App Store (Click to Expand)

   Open App Store Connect. Proceed to General → App Information section.
   The app ID is displayed in the Bundle ID field of the General Information sub-section.

   

2. Enter your mobile app's In-app purchase Issuer ID, referred to as Issuer ID in the App Store Connect. This is a special ID that identifies the issuer who created the authentication token. Also, enter the In-app purchase Key ID, referred to as Key ID in App Store Connect. This Key ID is a unique identifier associated with a cryptographic key you've created in the Generate In-App Purchase Key in App Store Connect section.

   How to find the purchase issuer ID of your mobile app in the App Store (Click to Expand)

   1. Open App Store Connect. Proceed to Users and Access → Integrations → In-App Purchase section.

   2. In the Active list, find the key you've created in the Generate In-App Purchase Key in App Store Connect section.

   3. Use Issuer ID as In-app purchase Issuer ID, Key ID as In-app purchase Key ID. Additionally, you'll need to upload the downloaded In-App Purchase Key file to Adapty. Remember to store the key somewhere safe, as you can only download it once.

   

   4. Enter your mobile app In-app purchase Key ID, and upload the In-App Purchase Key file you downloaded from App Store Connect in the Generate In-App Purchase Key in App Store Connect section.

   

3. Enter your mobile app App Store shared secret, also known as the App Store Connect Shared Secret, which is a 32-character hexadecimal string. It is used for in-app purchases and subscription receipt validation.

   How to find the shared secret of your mobile app in the App Store (Click to Expand)

   1. Open App Store Connect. Proceed to General → App Information section.
   2. Scroll down to the App-Specific Shared Secret sub-section.
      If the App-Specific Shared Secret sub-section is absent, ensure that you have an Account Holder or Admin role. If you have an Admin role and still cannot see the App-Specific Shared Secret sub-section, request the Account Holder of the app (the person who created the application in the App Store Connect) to generate the App Store shared secret for the app. After that, the sub-section will be visible to Admins as well
   3. Click the Manage button.

   

   4. In the App-Specific Shared Secret window, copy the contents of the Shared Secret field and enter it into the App Store shared secret field in Adapty. If no shared secret is visible, click the Manage button in the App-Specific Shared Secret dialog.
   5. Click the Done button in the App-Specific Shared Secret dialog of App Store Connect to close it.

4. Copy the contents of the URL for App Store server notification field in Adapty.

   

5. Enter it into fields Production Server URL and Sandbox Server URL in the App Store Connect, General → App Information section, App Store Server Notifications subsection.

   

6. Continue with Google Play Store connection configuration or click the Continue button if you do not sell via Play Store.