Tous les articles
Guide pratique8 min de lecture

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.

Une clé en laiton sur un bureau sombre à côté d'un ordinateur portable et d'un téléphone, symbolisant les autorisations du compte de service Google Play qui contrôlent les remboursements

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 ConsoleCe que Google dit qu'elle permetPeut-elle renvoyer de l'argent aux acheteurs ?
View financial data, orders, and cancellation survey responsesConsulter 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ésiliationNon
Manage orders and subscriptionsConsulter les commandes, rembourser les commandes, annuler les abonnementsOui
Admin (toutes les autorisations)Toutes les autres autorisations, plus l'invitation d'utilisateurs et la modification de leurs autorisationsOui, 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 faireCompte de service Google Play avec Manage orders and subscriptionsIn-App Purchase key d'Apple
Rembourser une commandeOui, commandes de 3 ans au plusNon, seul Apple rembourse
Couper l'accès d'un acheteurOui, avec revoke lors du remboursementNon
Annuler ou prolonger des abonnementsAnnuler, ouiProlonger les dates de renouvellement de 90 jours au plus, de façon irréversible
Lire les données d'achatOui, avec l'autorisation de consultationOui, historique des transactions et des remboursements
Répondre aux examens de remboursementOui, orders.reviewrefundOui, Send Consumption Information
Limiter à une seule appOui, via les autorisations d'appNon, 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.

Une développeuse à son bureau en train de révoquer un accès sur un ordinateur portable, avec une rangée de clés suspendues au mur et un crochet vide, illustrant comment retirer des autorisations du compte de service Google Play

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âcheCompte de service Google PlayIn-App Purchase key d'Apple
Qui peut la créerCréé dans Google Cloud, puis invité dans Users and permissions de Play ConsoleAccount 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éfautAucuneAucune, jusqu'à révocation
Comment couper l'accès viteSupprimer la clé dans IAM, ou retirer le compte dans Play ConsoleRévoquer la clé dans App Store Connect
Effets secondaires de la coupureTout outil qui utilise ce compte cesse d'appeler l'APILes 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

RefundHalt

Le pilote automatique des remboursements pour l'App Store et Google Play

Poursuivre la lecture

La prochaine demande de remboursement est déjà en route.

Configurez RefundHalt dans le temps qu'il vous faudrait pour lire un nouvel e-mail d'assistance au sujet d'un remboursement que vous n'avez pas pu contester.