Skip to main content

Connect to your App Store Account

To successfully integrate Botsi with the Apple App Store and manage in-app purchases, it is crucial to configure specific settings within your Apple Developer and App Store Connect accounts. This setup ensures seamless communication between your app and Apple's services, enabling features like subscription management and purchase validation.

For Botsi, you will need to complete the following steps:

Let's walk through each of these steps.

1. Get Your App’s Bundle ID​

The Bundle ID is a unique identifier for your app, essential for configuring in-app purchases and integrating with services like Botsi.

To get you Bundle ID:

  1. Open App Store Connect. Select your app and proceed to General > App Information section.
  2. Copy the Bundle ID in the General Information sub-section.
Note

The Bundle ID is required before you can enable the In-App Purchase API.

2. Enable the In-App Purchase API (StoreKit 2)​

Enabling the In-App Purchase API allows your app to securely validate purchases and access subscription data. Follow the steps below to enable your In-App Purchase API:

  1. In App Store Connect, select Users and Access.
  2. In Integrations, go to the Keys tab and select In-App Purchase.
  3. Click the Generate In-App Purchase Key to generate a new key. A modal window will open.
  1. Enter a Name for the key (for your reference) and click Generate.
Key File Details

Once you have generated your key:

  • Download the .p8 key file immediately and store it securely.
  • Save the Key ID and Issuer ID displayed. You will need all three for Botsi configuration.

3. Get Your Shared Secret​

The Shared Secret is a string of characters used to validate StoreKit 1 receipts, especially for auto-renewable subscriptions. It is used primarily when calling the Apple’s Receipt Validation endpoint.

To get it:

  1. Open App Store Connect, and access your app.
  2. Navigate to the General section and select App Information.
  3. Scroll to the App-Specific Shared Secret section and click Manage. A modal window will open.
  1. Copy the 32-character hexadecimal string displayed under the Shared Secret column.
Applicability

Your Shared Secret is only applicable if you are using:

  • StoreKit 1
  • Legacy receipt validation
  • Auto-renewable subscriptions

It is not used with StoreKit 2, which instead relies on the .p8 key plus the server communication with Apple.

Add your Credentials to Botsi​

Once you have collected the necessary information from the App Store Connect, you can enter it in the Botsi dashboard as shown below.

  1. Go to the Botsi Dashboard and click Home. There, you will visualize all the apps connected to your Botsi account.
  2. Find the app you want to work with and click Setup Guide under the App Setup column. The app Quickstart Guide page will open.
  3. In the Connect App Stores tab, enable the toggle: My App is available in iOS App Store.
  4. Click on iOS App Settings.
  1. In App Settings > iOS SDK, enter the following values:
  • Bundle ID (e.g., com.botsi.app)
  1. In In-app purchase API (storeKit2) add the following:
  • Issuer ID
  • Key ID
  • Your Private Key (.p8 file) when available.
Note

You can have up to 10 active in-app purchase keys at a time.

  1. Get the app-specific shared secret from the App Store Connect and paste it.
Note

Only users with the Account Holder or Admin role can generate or view the shared secret.

Additionally, from these settings, you can:

  1. Copy and paste the provided URL for App Store server notifications in App Store Connect.
  2. Add a subscription key to use Apple promotional offers.
  3. Save your changes once you finish.