Configuration de l'App Store d'Apple

Vous aurez besoin de ceci, et cela prend environ 5 minutes :

• Un accès Admin ou Account Holder à App Store Connect.
• Une clé d'API App Store Connect, qui vous donne trois valeurs : un Issuer ID, un Key ID et un fichier de clé privée .p8.

Aucun fichier n'est envoyé à Apple, et aucune modification n'est faite au binaire de votre app.

L'Issuer ID, le Key ID et le fichier .p8 proviennent tous du même endroit dans App Store Connect :

1. Connectez-vous à App Store Connect, ouvrez Users and Access, sélectionnez l'onglet Integrations et choisissez In-App Purchase dans la section Keys à gauche.
2. Copiez l'Issuer ID affiché en haut de la page. C'est une valeur unique pour tout le compte, partagée par chaque clé que vous générez.
3. Cliquez sur le bouton + à côté de Active pour générer une nouvelle clé. Nommez-la Refund Sensor, réglez Access sur Admin et cliquez sur Generate.
4. Copiez le Key ID de la nouvelle clé, puis cliquez sur la ligne de la clé pour faire Download du fichier .p8. Apple ne vous laisse le télécharger qu'une seule fois, gardez-le donc en lieu sûr.

Dans Refund Sensor, ouvrez Add app et choisissez Apple App Store. Collez votre Issuer ID et votre Key ID, téléversez le fichier .p8, puis cliquez sur Continue. Nous vérifions la clé auprès d'Apple et la chiffrons au repos avec AES-256-GCM avant de la stocker. Elle n'est plus jamais affichée ni exposée dans les journaux.

Une fois la clé vérifiée, Refund Sensor récupère toutes les apps qu'il peut voir dans votre compte App Store Connect. Cherchez par nom ou par bundle ID, sélectionnez les apps à défendre et cliquez sur Connect. Chaque app connectée reçoit sa propre URL de webhook.

C'est la dernière étape, faite une fois par app après l'avoir connectée. Apple envoie ses notifications serveur à une seule URL :

1. Copiez l'URL de webhook de l'app depuis Refund Sensor (affichée sur la carte de l'app connectée).
2. Dans App Store Connect, ouvrez la page App Information de cette app et descendez jusqu'à App Store Server Notifications.
3. Cliquez sur Set Up URL pour la Production Server URL, collez l'URL et enregistrez. Faites de même pour la Sandbox Server URL, afin que le trafic de test et le trafic réel atteignent tous deux Refund Sensor.

Chaque app connectée a sa propre URL unique, générée pour vous et affichée sur sa carte dans Refund Sensor. Copiez-la de là plutôt que de la saisir à la main.

Apple n'autorise qu'une seule URL de notifications serveur, et si une plateforme d'abonnements l'utilise déjà, ne la remplacez pas. Demandez plutôt à cette plateforme de réacheminer une copie de chaque notification Apple brute vers votre URL de webhook Refund Sensor, ainsi les deux continuent de fonctionner. Voir Réacheminement des notifications pour les étapes exactes de RevenueCat, Adapty et Apphud.

Refund Sensor confirme qu'il peut recevoir les notifications d'Apple avant de commencer à agir sur des événements réels. Tant que la connexion n'est pas vérifiée, les événements en direct sont enregistrés mais sans action, ainsi une configuration à moitié faite n'envoie jamais une réponse par erreur.