Content of this article
- Preliminary Remarks
- App Store Connect
- Create Connection in the Merchant Backend
1. Preliminary Remarks
The App Store Connect backend provides extensive information on apps that have been created. Only the following information is required for the connection with plenigo:
- the name of the app
- the app-specific key (Shared Secret)
- Setting up the webhook
Name of the app
The name of the app is understood to be the unique bundle ID. 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 initiate and authenticate a connection between the Apple API and the plenigo API. The Shared Secret is a unique code to call app receipts for auto-renewable subscriptions for the selected app.
If multiple apps are to be used, each app needs its own Shared Secret.
Note: Only the roles Account Owner and Administrator can view and create a Shared Secret. |
2. App Store Connect
Follow the following steps to get the required information from the App Store Connect Backend.
1. Name of the app (Bundle-ID)
- In the main menu item Apps, open the desired app.
- In the navigation bar on the left hand side under General, click on App Information.
- Under General Information, you will find the Bundle ID (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 section App-specific key (Shared Secret), click on the link Manage.
- Create a new Shared Secret or copy the existing one.
3. Setting up the plenigo webhook
The webhook setup can also be found in the main menu item Apps > desired App > General > App Information.
- In the section App Store Server Notifications, click on the link Setup URL.
- Enter the URL of the plenigo webhook in the field Production Server URL.
- 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 plenigo Company ID can be viewed in the Merchant Backend in the desired client under Settings / Development / JS-SDK. - Version selection: Version 2
3. Create Connection in the Merchant Backend
The data copied from the App Store Connect can now be stored in the Merchant Backend.
- Open the desired client.
- In the Settings menu item, open Development.
- Open the Mobile Apps menu item.
- In the action bar, click on Add iOS App.
- Add the data from the App Store Connect.