Connect to App Store

Connecting Botsi to the App Store takes four pieces of information from your Apple Developer and App Store Connect accounts: your Bundle ID, an In-App Purchase Key, the Issuer ID and Key ID that go with it, and (if you use StoreKit 1) your Shared Secret. This page covers collecting each, then entering them in Botsi.

Getting your Bundle ID#

The Bundle ID uniquely identifies your app, and everything else here depends on it.

Open App Store Connect → Apps and select your app.
Go to General → App Information.
Copy the Bundle ID from General Information.

Enabling the In-App Purchase API (StoreKit 2)#

The In-App Purchase Key is what lets Botsi validate purchases and read subscription data.

In App Store Connect, select Users and Access.
Under Integrations, go to the Keys tab and select In-App Purchase.
Choose Generate In-App Purchase Key.
Enter a name for your own reference and choose Generate.

The .p8 file downloads once and cannot be re-downloaded

Download it immediately and store it somewhere durable. If you lose it, the only remedy is revoking the key and generating a new one.

Save the Key ID and Issuer ID shown alongside it. All three are needed to configure Botsi, and you can hold at most 10 active in-app purchase keys at a time.

Getting the Issuer ID and Key ID#

If you did not record them when generating the key, they are in App Store Connect → Users and Access → Integrations → In-App Purchase, in the Active keys list.

Getting your Shared Secret#

The Shared Secret validates StoreKit 1 receipts, mainly for auto-renewable subscriptions, and is used when calling Apple's receipt validation endpoint.

Open App Store Connect → Apps and select your app.
Go to General → App Information.
Scroll to App-Specific Shared Secret and choose Manage.
Copy the 32-character hexadecimal string.

You need Account Holder or Admin to see this section

If App-Specific Shared Secret does not appear, your role is too limited. An Admin who still cannot see it needs the Account Holder (the person who originally created the app in App Store Connect) to generate the secret first. It appears for Admins afterwards.

The Shared Secret applies only to StoreKit 1, legacy receipt validation, and auto-renewable subscriptions under those. StoreKit 2 does not use it. It relies on the .p8 key and server communication with Apple instead.

Entering the credentials in Botsi#

Go to the Botsi dashboard at https://app.botsi.com and choose Home.
Find your app and choose Setup Guide under App Setup.
On the Connect App Stores tab, enable My App is available in iOS App Store.
Choose iOS App Settings.
Under App Settings → iOS SDK, enter:
- The Bundle ID, for example com.botsi.app.
- Under In-app purchase API (storeKit2): the Issuer ID, the Key ID, and your .p8 private key.
- The app-specific Shared Secret, if you have one.
Choose Save.

Two more things live on this screen:

The URL for App Store server notifications, which you copy into App Store Connect. See App Store Server Notifications.
A Subscription key ID and private key, needed for Apple promotional offers. This is the same key you generated above.