Les autorisations du compte de service Google Play décident qui peut rembourser vos commandes : accordez le strict nécessaire
Une seule autorisation Play Console permet à un compte de service de rembourser n'importe quelle commande et d'annuler n'importe quel abonnement. Voici les autorisations du compte de service Google Play dont un outil de remboursement a vraiment besoin, ce qu'une clé divulguée permet sur chaque store, et comment restreindre, faire tourner et révoquer les clés.

Points clés
- L'autorisation Manage orders and subscriptions (gérer les commandes et les abonnements) de Google Play permet de consulter les commandes, de les rembourser et d'annuler des abonnements : tout compte de service qui la détient peut donc renvoyer de l'argent à vos acheteurs.
- Le guide de Google Play Developer API indique que les API de facturation Google Play exigent deux autorisations Play Console : View financial data, orders, and cancellation survey responses, et Manage orders and subscriptions.
- La méthode orders.refund de Google Play Developer API peut rembourser toute commande d'achat unique ou d'abonnement datant de 3 ans au plus et, avec revoke à true, elle coupe immédiatement l'accès de l'acheteur.
- Les clés de compte de service Google Cloud n'expirent pas par défaut, et Google précise qu'une clé poussée dans un dépôt de code doit être supprimée dans IAM, car la retirer du dépôt ne suffit pas.
- L'In-App Purchase key d'Apple ne peut pas émettre de remboursements, mais elle peut appeler App Store Server API, y compris les endpoints qui prolongent la date de renouvellement d'un abonnement de 90 jours au plus, une prolongation qu'Apple déclare irréversible.
- Seul un Account Holder ou un Admin peut générer une In-App Purchase key dans App Store Connect, la clé privée ne se télécharge qu'une fois et une clé révoquée ne peut pas être rétablie.
Donnez deux autorisations Play Console à un compte de service et il pourra rembourser n'importe quelle commande de votre app. Ce n'est pas une erreur de configuration. C'est exactement ainsi que Google a conçu Google Play Developer API, et c'est pourquoi la clé JSON derrière votre outil de remboursement mérite le même soin que l'accès à votre banque.
La plupart des équipes configurent cela une fois, dans l'urgence, en cochant ce qui a fait réussir le premier appel API. Ce guide prend le chemin inverse. Il détaille les autorisations du compte de service Google Play dont les remboursements et les rétrofacturations ont réellement besoin, ce que chaque store laisse faire à une clé volée, et comment limiter le rayon d'impact.
Ce que permettent vraiment les autorisations du compte de service Google Play
Un compte de service est un utilisateur robot. Vous le créez dans Google Cloud, puis vous invitez son adresse e-mail dans Play Console, sous Users and permissions (utilisateurs et autorisations), comme vous inviteriez un collègue. Dès lors, il peut faire tout ce que ces autorisations permettent, via l'API, à toute heure, sans second facteur.
Les deux autorisations exigées par les API de facturation
Le guide de Google Play Developer API est précis. Pour utiliser les API de facturation Google Play, vous accordez deux autorisations : View financial data, orders, and cancellation survey responses (voir les données financières, les commandes et les réponses à l'enquête de résiliation), et Manage orders and subscriptions (gérer les commandes et les abonnements). La première permet au compte de lire les commandes et d'utiliser l'API Purchases. La seconde est celle qui touche à l'argent.
| Autorisation Play Console | Ce que Google dit qu'elle permet | Peut-elle renvoyer de l'argent aux acheteurs ? |
|---|---|---|
| View financial data, orders, and cancellation survey responses | Consulter les rapports financiers, les rapports de ventes et les commandes, accéder à l'API Purchases, télécharger les réponses à l'enquête de résiliation | Non |
| Manage orders and subscriptions | Consulter les commandes, rembourser les commandes, annuler les abonnements | Oui |
| Admin (toutes les autorisations) | Toutes les autres autorisations, plus l'invitation d'utilisateurs et la modification de leurs autorisations | Oui, et il peut s'en accorder davantage |
Ce que peut faire une clé dotée de droits de remboursement
La méthode orders.refund de Google Play Developer API rembourse la commande d'un abonnement ou d'un achat intégré. Google précise que les commandes de plus de 3 ans ne peuvent pas être remboursées, ce qui signifie que toutes les plus récentes le peuvent. Passez revoke à true et l'accès de l'acheteur prend fin immédiatement. Pour les abonnements, purchases.subscriptionsv2.revoke avec remboursement intégral fait la même chose.
Ce sont les bons outils quand vous comptez vous en servir. Les recommandations antifraude de Google vous disent de rembourser et de révoquer un achat qui échoue à vos contrôles plutôt que de le laisser expirer. Le problème, c'est une clé capable de le faire sur toutes les apps de votre compte alors qu'elle n'en avait besoin que d'une.
Ce qu'une clé divulguée peut vous coûter
Faites le calcul avant de décider de l'effort que cela mérite. Sur Google Play, une clé avec Manage orders and subscriptions peut rembourser des commandes un appel après l'autre, et chaque remboursement renvoie la vente à l'acheteur. Un script ne se fatigue pas. Le plafond, c'est votre historique de commandes des 3 dernières années.
Les coûts qui ne reviennent pas avec le remboursement
Un remboursement annule la vente. Il n'annule pas ce que vous avez dépensé pour la servir. Cette dépense reste dans vos comptes, que le remboursement vienne d'un client ou d'un attaquant.
- Le calcul déjà consommé : le temps GPU et serveur derrière chaque génération, rendu ou réponse de modèle reçu par l'acheteur.
- Les appels API déjà payés : les frais par requête des fournisseurs de modèles, de cartes, de voix ou de données.
- Le stockage que vous payez encore : les fichiers et l'historique que ces comptes conservent sur vos serveurs.
- Les versements déjà effectués : les versements aux créateurs, affiliés ou vendeurs liés à ces achats ne reviennent pas avec le remboursement.
Côté Apple, le risque prend une autre forme
App Store Server API d'Apple n'a aucun endpoint qui émet un remboursement. C'est Apple qui décide des remboursements. Mais la même In-App Purchase key peut prolonger la date de renouvellement d'un abonné de 90 jours au plus, deux fois par période de 365 jours et par client, ou pour tous les abonnés actifs d'un produit en une seule requête groupée. Apple précise qu'une prolongation est irréversible. Pendant ces jours, l'abonné n'est pas facturé et continue d'utiliser votre app, si bien que vos factures de calcul, de stockage et d'API continuent de tourner sans aucun revenu.
| Ce qu'une clé volée peut faire | Compte de service Google Play avec Manage orders and subscriptions | In-App Purchase key d'Apple |
|---|---|---|
| Rembourser une commande | Oui, commandes de 3 ans au plus | Non, seul Apple rembourse |
| Couper l'accès d'un acheteur | Oui, avec revoke lors du remboursement | Non |
| Annuler ou prolonger des abonnements | Annuler, oui | Prolonger les dates de renouvellement de 90 jours au plus, de façon irréversible |
| Lire les données d'achat | Oui, avec l'autorisation de consultation | Oui, historique des transactions et des remboursements |
| Répondre aux examens de remboursement | Oui, orders.reviewrefund | Oui, Send Consumption Information |
| Limiter à une seule app | Oui, via les autorisations d'app | Non, la clé fonctionne sur toutes les apps de votre équipe |
Comment restreindre les autorisations du compte de service Google Play
Play Console distingue les autorisations de compte des autorisations d'app. Les autorisations d'app ne s'appliquent qu'aux apps que vous sélectionnez. Ce seul réglage fait plus pour votre sécurité que tout le reste de cette liste.
Accordez sur une app, pas sur tout le compte
Invitez chaque compte de service avec des autorisations d'app sur les apps qu'il sert. Un outil de remboursement pour un jeu n'a pas besoin de droits de remboursement sur votre app de méditation. Un piège : View financial data, orders, and cancellation survey responses n'existe qu'au niveau du compte, et son équivalent au niveau de l'app s'appelle View financial data. Choisissez celle de niveau app quand vous restreignez.
Séparez la lecture du remboursement
Toutes les tâches n'ont pas besoin de Manage orders and subscriptions. Des analyses qui ne font que lire les commandes peuvent tourner sur un compte doté de droits de consultation et rien d'autre. Réservez la clé capable de rembourser au seul service qui appelle réellement orders.refund, orders.reviewrefund ou les endpoints revoke.
Ne donnez jamais Admin à un robot
Admin accorde toutes les autorisations, et Google range parmi ses droits l'invitation d'utilisateurs et la gestion de leurs autorisations. Une clé Admin divulguée peut élargir son propre accès ou inviter quelqu'un de nouveau. Aucun flux de remboursement n'en a besoin.
Demandez aux fournisseurs comment ils se connectent
Certains outils vous demandent d'envoyer une clé JSON. D'autres vous donnent l'adresse e-mail de leur propre compte de service à inviter : aucune de vos clés ne quitte alors votre contrôle, et vous pouvez retirer leur accès depuis Users and permissions en un clic. Si un fournisseur a besoin de droits de remboursement, demandez lesquels, sur quelles apps et pourquoi.

Comment stocker, faire tourner et révoquer les clés
Les deux stores disent la même chose avec des mots différents. Ne mettez pas de clés dans un dépôt de code et ne les embarquez pas dans votre app. Les différences tiennent à ce qui se passe quand quelque chose tourne mal.
Les clés Google Cloud n'expirent pas d'elles-mêmes
Les recommandations de Google Cloud notent que les clés de compte de service n'ont pas de date d'expiration par défaut. Elles conseillent de les faire tourner régulièrement et de désactiver celles que vous n'utilisez plus. Si une clé atterrit dans un dépôt, Google demande de la supprimer dans IAM au plus vite, car l'effacer du dépôt ne suffit pas. Google Cloud peut aussi désactiver automatiquement les clés divulguées qu'il détecte lorsque la contrainte Service Account Key Exposure Response est définie sur DISABLE_KEY, mais il ne garantit pas de repérer chaque fuite.
Les clés Apple se téléchargent une fois et se révoquent pour de bon
Seul un Account Holder ou un Admin peut générer une In-App Purchase key. Apple conserve la partie publique, vous téléchargez le fichier privé .p8 une seule fois, et Apple n'en garde aucune copie. Si vous soupçonnez qu'une clé est compromise, Apple demande de la révoquer immédiatement dans App Store Connect, sous Users and Access, Integrations, In-App Purchase. Une clé révoquée ne peut pas être rétablie, et sa révocation bloque aussi l'utilisation des offres promotionnelles signées avec elle : mettez donc ces offres à jour avant ou juste après.
| Tâche | Compte de service Google Play | In-App Purchase key d'Apple |
|---|---|---|
| Qui peut la créer | Créé dans Google Cloud, puis invité dans Users and permissions de Play Console | Account Holder ou Admin |
| Peut-on retélécharger le secret ? | Vous créez une nouvelle clé | Non, un seul téléchargement |
| Expiration par défaut | Aucune | Aucune, jusqu'à révocation |
| Comment couper l'accès vite | Supprimer la clé dans IAM, ou retirer le compte dans Play Console | Révoquer la clé dans App Store Connect |
| Effets secondaires de la coupure | Tout outil qui utilise ce compte cesse d'appeler l'API | Les offres promotionnelles signées avec elle ne sont plus utilisables |
Une courte checklist
- Un compte de service par tâche, invité avec des autorisations d'app uniquement sur les apps qu'il sert.
- Manage orders and subscriptions uniquement sur le compte qui rembourse, révoque ou répond réellement aux examens.
- Aucun Admin sur un compte robot.
- Des clés dans un gestionnaire de secrets, jamais dans un dépôt, un journal de build ou une app mobile.
- Une liste écrite de chaque clé, de qui l'a créée et du service qui l'utilise, pour qu'une révocation ne casse pas vos réponses aux remboursements.
- Une revue de Users and permissions dans Play Console et des clés App Store Connect chaque fois que quelqu'un quitte l'équipe ou qu'un fournisseur est abandonné.
Questions fréquentes
- De quelles autorisations Play Console un compte de service a-t-il besoin pour les remboursements et les rétrofacturations ?
- Il lui faut Manage orders and subscriptions pour rembourser des commandes, annuler des abonnements et traiter les commandes, ainsi qu'un accès en consultation aux commandes. Le guide de Google Play Developer API cite View financial data, orders, and cancellation survey responses et Manage orders and subscriptions comme les deux autorisations requises par les API de facturation Google Play.
- Un compte de service Google Play peut-il rembourser des commandes ?
- Oui, s'il détient l'autorisation Manage orders and subscriptions. La page d'aide de Google indique que cette autorisation permet de consulter les commandes, de les rembourser et d'annuler des abonnements, et la méthode d'API orders.refund rembourse toute commande de 3 ans au plus.
- Quelqu'un qui possède mon In-App Purchase key App Store peut-il rembourser mes clients ?
- Non. App Store Server API n'a pas d'endpoint de remboursement, car c'est Apple qui décide des remboursements. Une clé volée peut tout de même lire l'historique des transactions et des remboursements, envoyer des informations de consommation et prolonger les dates de renouvellement des abonnements de 90 jours au plus, ce qu'Apple déclare irréversible.
- Les clés de compte de service Google Play expirent-elles ?
- Pas par défaut. Les recommandations de Google Cloud indiquent que les clés que vous créez et téléchargez n'ont pas de date d'expiration sauf si vous en configurez une, et conseillent de les faire tourner régulièrement et de désactiver celles que vous n'utilisez plus.
- Que faire si la clé JSON de mon compte de service a été poussée sur GitHub ?
- Supprimez immédiatement la clé dans IAM de Google Cloud et créez-en une nouvelle. Google précise que retirer la clé du dépôt ne suffit pas, car quiconque l'a copiée peut encore l'utiliser tant que la clé elle-même n'est pas supprimée.
Sources et lectures complémentaires
- Play Console Help: Add developer account users and manage permissions
- Google Play Developer API: Getting started (service accounts and required permissions)
- Google Play Developer API: orders.refund reference
- Android Developers: Fight fraud and abuse
- Google Cloud: Best practices for managing service account keys
- Apple Developer: Creating API keys to authorize API requests
- App Store Connect Help: Generate keys for in-app purchases
- Apple Developer: Extending the renewal date for auto-renewable subscriptions
RefundHalt
Le pilote automatique des remboursements pour l'App Store et Google Play
Poursuivre la lecture
Le Brésil vérifie désormais quels jeux vendent encore des loot boxes aux mineurs, et la facture arrive avec les remboursements de loot boxes
Le ministère brésilien de la Justice a demandé à l'autorité de protection des données de surveiller six jeux qui vendent des loot boxes sans vérifier l'âge. Voici ce qu'exige la loi, ce qu'Apple et Google imposent déjà, et comment chiffrer et traiter les remboursements de loot boxes quand la boîte est déjà ouverte.
Les achats intégrés accidentels sont les remboursements que vous ne pouvez pas gagner, la solution se trouve donc sur votre écran d'achat
Les achats intégrés accidentels reviennent sous forme de remboursements sur les deux stores, et aucune donnée d'usage ne prouve qu'un appui était voulu. Voici comment Apple et Google les étiquettent, ce que chacun vous coûte en calcul et en reversements, et la conception d'écran d'achat qui les bloque avant même que le débit existe.