Remarques préliminaires
Pour connecter les applications (StoreKit v2) au Frisbii Media Merchant Backend, les informations suivantes, disponibles dans App Store Connect, sont nécessaires :
Nom de l'application (bundle ID)
Clé spécifique à l'application (shared secret)
Issuer ID
Key ID
Configuration du webhook
Nom de l'application
Le bundle ID unique fait office de nom de l'application. Le bundle ID doit correspondre à l'ID utilisé lors du développement de l'application (dans Xcode). Attention : n'utilisez pas l'information du champ de texte libre « Nom » dans le backend App Store Connect.
Clé spécifique à l'application (shared secret)
La clé spécifique à l'application (shared secret) est nécessaire pour établir et authentifier une connexion entre l'API Apple et l'API Frisbii Media. Le shared secret est un code unique permettant de récupérer les reçus des abonnements à renouvellement automatique pour une application donnée. Si plusieurs applications sont utilisées, un shared secret distinct doit être utilisé pour chacune d'elles.
Remarque : seuls les rôles Titulaire du compte et Administrateur peuvent afficher et créer un shared secret.
App Store Connect
Procédez comme suit pour obtenir les informations nécessaires dans le backend App Store Connect.
1. Nom de l'application (bundle ID)
Ouvrez l'application souhaitée dans l'élément de menu principal Apps.
Cliquez sur Général > Informations sur l'app dans la barre de navigation à gauche.
Le bundle ID se trouve dans la section Informations générales (structure du bundle ID : com.companyname.appname)
2. Shared secret Le shared secret se trouve également dans l'élément de menu principal Apps > application souhaitée > Général > Informations sur l'app.
Dans la section Clé spécifique à l'app (shared secret), cliquez sur le lien Gérer.
Créez un nouveau shared secret ou copiez le shared secret existant.
3. Issuer ID et Key ID
Ouvrez l'élément de menu principal Utilisateurs et accès.
Ouvrez l'onglet Intégrations.
Par défaut, le sous-élément App Store Connect API > Clés d'équipe s'ouvre.
Copiez ici l'Issuer ID.
Le Key ID se trouve dans le tableau, dans la colonne Key ID.
4. Configurer le webhook Frisbii Media
La configuration du webhook se trouve également dans l'élément de menu principal Apps > application souhaitée > Général > Informations sur l'app.
Dans la section Notifications du serveur App Store, cliquez sur le lien Configurer l'URL.
Saisissez l'URL du webhook Frisbii Media dans le champ URL du serveur de production :
- Système de stage : https://callbacks.frisbii-media-stage.com/callbacks/v1.0/appStore/{companyId}/appleappstore
- Système de production : https://callbacks.frisbii-media.com/callbacks/v1.0/appStore/{companyId}/appleappstore
Le CompanyId Frisbii Media est visible dans l'URL du Merchant Backend, dans le client souhaité : Où trouver le CompanyID ?Sélectionnez la version : Version 2
Créer la connexion dans le Merchant Backend
Vous pouvez ensuite enregistrer dans le Frisbii Media Merchant Backend les données copiées précédemment depuis App Store Connect.
Ouvrez le client souhaité.
Dans l'élément de menu principal Paramètres, ouvrez le sous-élément Développement.
Ouvrez l'élément de menu Applications mobiles.
Cliquez sur Ajouter une application iOS dans la barre d'actions.
Enregistrez les données issues d'App Store Connect.