Preliminary Remarks
In order to connect the apps (Storekit v2) with the Frisbii Media Merchant Backend, the following information is required, which is available in App Store Connect:
Name of the app (bundle ID)
App-specific key (shared secret)
Issuer ID
Key ID
Setting up the webhook
Name of the app
The unique bundle ID is understood to be the name of the app. The bundle ID must match the ID used during app development (within X-Code). Attention: Please do not use the information from the free text field "Name" in the App Store Connect backend.
App-specific key (shared secret)
The app-specific key (shared secret) is required to establish and authenticate a connection between the Apple API and the Frisbii Media API. The Shared Secret is a unique code to retrieve receipts for subscriptions with automatic renewal for a selected app. If several apps are to be used, a separate shared secret must be used for each app.
Note: Only the account owner and administrator roles can display and create a shared secret.
App Store Connect
The following steps must be carried out to obtain the necessary information from the App Store Connect backend .
1. Name of the app (bundle ID)
Open the desired app in the main menu item Apps.
Click on General > App information in the navigation bar on the left-hand side.
The Bundle ID is located in the General information section (structure of the Bundle ID: com.companyname.appname)
2. Shared Secret The shared secret can also be found in the main menu item Apps > desired app > General > App information.
In the App-specific key (Shared Secret) section, click on the Manage link .
Create a new shared secret or copy the existing shared secret.
3. Issuer ID and Key ID
Open the main menu item Users and access rights.
Open the Integration tab .
By default, the App Store Connect API sub-item > Team key opens.
The Issuer ID can now be copied here.
The key ID can be found in the table in the Key ID column.
4. Setting up the Frisbii Media webhook
The webhook setup can also be found in the main menu item Apps > desired app > General > App information.
Click on the Set up URL link in the App Store server notifications section.
Enter the URL of the Frisbii Media webhook in the Production Server URL field:
- Stage System: https://callbacks.plenigo-stage.com/callbacks/v1.0/appStore/{companyId}/appleappstore
- Live System: https://callbacks.plenigo.com/callbacks/v1.0/appStore/{companyId}/appleappstore
The Frisbii Media CompanyId can be viewed in the URL in the Merchant Backend in the desired client: Where can I find the CompanyID?Version selection: Version 2
Creating Connection in the Merchant Backend
The data previously copied from the App Store Connect can be stored in the Frisbii Media Merchant Backend in the next step.
Open the desired client.
In the main menu item Settings , open the sub-item Development.
Open the menu item Mobile Apps .
Click on Add iOS App in the action bar.
Store the data from the App Store Connect.