> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Marketplace Integration - Apple

> Connect an Apple App Store app to your PlayFab title in Game Manager using the iOS bundle ID and App Store Connect credentials for Economy v2.

# Marketplace integration: Apple

This tutorial shows you how to successfully integrate an Apple App Store application into your Title in Game Manager.

## Prerequisites

1. Access to [App Store Connect](https://appstoreconnect.apple.com/).
2. An app already [created](https://developer.apple.com/help/app-store-connect/create-an-app-record/add-a-new-app) in the **App Store Connect**.
3. A Title created in [Game Manager](https://developer.playfab.com/).

## Step 1: Get the iOS App Bundle ID

The **iOS App Bundle ID** is a unique identifier for your app on the App Store. Used to differentiate your app from other on the platform, and is typically in a reverse-DNS format, such as `com.yourcompany.yourappname`. The bundle ID is often generated when creating an app for the first time by following the [Certificates, Identifiers & Profiles](https://developer.apple.com/account/resources/identifiers/bundleId/add/bundle) link part of the create-an-app window.

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/marketplace-integrations/apple-app-store/bundle-id-at-app-creation.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=00049832a7a65b2ef45a0c9a24486ef6" alt="Bundle ID at app creation" width="545" height="92" data-path="images/playfab/economy-monetization/economy-v2/marketplace-integrations/apple-app-store/bundle-id-at-app-creation.png" />

To get the **iOS App Bundle ID** for your app, go into the [Apps section](https://appstoreconnect.apple.com/apps) of the **App Store Connect** and select your desired app. For this tutorial, we have an app already created called `PlayFabCommerce_IOS`. Once selected, you see the general app overview page, from where you should navigate to **App Information** under **General** on the left navigation menu.

This displays your app's general information, from where you find your **iOS App Bundle ID** under the **General Information** section. Remember, the ID is the text following a reverse DNS format. In this case, it's `com.microsoft.playfabcommerce.ios`.

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/marketplace-integrations/apple-app-store/app-bundle-id.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=095405aef3051366171a144c638d132b" alt="App bundle ID" width="575" height="119" data-path="images/playfab/economy-monetization/economy-v2/marketplace-integrations/apple-app-store/app-bundle-id.png" />

## Step 2: Get the App-Specific Shared Secret

The **App-Specific Shared Secret** is another unique code used to verify receipts for the app's autorenewable subscriptions or in-app purchases. You can read more about it in [Apple's documentation](https://developer.apple.com/help/app-store-connect/configure-in-app-purchase-settings/generate-a-shared-secret-to-verify-receipts).

To get your app's **App-Specific Shared Secret**, navigate to the **App Information** section under **General** for your desired app. Such as what we did in [Step 1](#step-1-get-the-ios-app-bundle-id). Scroll down to the **App-Specific Shared Secret** section and select **Manage**.

This displays a window with your **App-Specific Shared Secret** alongside the date it was generated.

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/marketplace-integrations/apple-app-store/app-specific-shared-secret-value.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=f213f680dbbda19ef22a2db3e546d990" alt="App specific shared secret value" width="685" height="339" data-path="images/playfab/economy-monetization/economy-v2/marketplace-integrations/apple-app-store/app-specific-shared-secret-value.png" />

<Note>
  Only users with the Account Holder and the Admin roles can view and generate a shared secret.
</Note>

## Step 3: Link to PlayFab through Game Manager

Now that you have both your **iOS App Bundle ID** and your **App-Specific Shared Secret**. It's time to link it to your **Title** in PlayFab's [Game Manager](https://developer.playfab.com/).

1. Open [Game Manager](https://developer.playfab.com/) and select your **Title**.

2. Once inside your Title screen, select the **Add-ons** option from the left navbar.

3. Search for and select the **Apple** option.

4. On the right side of the screen, select the **Install Apple** button, which displays a set of information you must include before completing the integration.

5. For the **iOS App Bundle ID** use the ID obtained from [Step 1](#step-1-get-the-ios-app-bundle-id) and for the **iOS App Shared Secret** use the secret value obtained from [Step 2](#step-2-get-the-app-specific-shared-secret).

   <img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/marketplace-integrations/apple-app-store/apple-completed-fields.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=73292a64b565e37a717e75fc3aca2b00" alt="Apple completed fields" width="1280" height="1500" data-path="images/playfab/economy-monetization/economy-v2/marketplace-integrations/apple-app-store/apple-completed-fields.png" />

6. Press **Install Apple**. It validates your data and, if successful, changes the notice above the fields you just completed to **Apple is installed**.


## Related topics

- [Marketplace integration - Overview](/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/overview.md)
- [Marketplace integration - Steam](/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/steam.md)
- [Marketplace integration - Microsoft Store](/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/microsoft.md)
- [Marketplace integration - Google](/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/google.md)
- [Fraud prevention quickstart](/services/playfab/economy-monetization/economy-v2/fraud-prevention/quickstart.md)
