Configuration de Google Play

Refund Sensor se connecte à Google Play avec un compte de service que vous créez dans votre propre projet Google Cloud. Il n'expire jamais et ne demande aucune réautorisation. Vous aurez besoin de :

• Un projet Google Cloud sur le compte propriétaire de votre Play Console (un projet gratuit suffit).
• Un compte de service avec une clé JSON que vous pouvez télécharger.
• Un accès à la Play Console plus le rôle Pub/Sub Admin accordé à ce compte.
• Les noms de package ou les URL Play Store que vous voulez défendre.

1. Ouvrez la Google Cloud Console avec le compte propriétaire de votre Play Console, puis sélectionnez ou créez un projet. Dans le menu de gauche, ouvrez IAM & Admin et cliquez sur Service accounts.
2. Cliquez sur + Create service account, donnez-lui un nom comme RefundSensor Google Play API, puis cliquez sur Create and continue et Done. Vous pouvez ignorer les rôles facultatifs ici.
3. Copiez l'e-mail du compte de service (il finit par .iam.gserviceaccount.com). Vous en aurez besoin aux étapes suivantes.
4. Ouvrez le compte de service, passez à l'onglet Keys, cliquez sur Add key → Create new key, choisissez JSON et cliquez sur Create. Google télécharge un fichier .json. Gardez-le en sûreté ; Google ne vous laissera pas le retélécharger.

Votre projet a besoin de deux API Google activées (une étape unique par projet). Dans la Google Cloud Console, votre projet sélectionné, cherchez et activez chacune :

• Google Play Android Developer API, qui permet au compte de service de lire vos données de remboursement et de commande.
• Cloud Pub/Sub API, qui alimente les notifications de remboursement en temps réel. Vérifiez que c'est bien Cloud Pub/Sub, et non Pub/Sub Lite, qui est un produit différent.

Dans Refund Sensor, ouvrez Add app, choisissez Google Play et téléversez le fichier de clé .json. Nous le vérifions auprès de Google et le stockons chiffré au repos avec AES-256-GCM.

Invitez le compte de service dans la Play Console et donnez-lui un accès financier à deux endroits, car les données de remboursement (achats annulés) sont lues au niveau du compte :

1. Dans la Google Play Console, ouvrez Users and permissions → Invite new users et collez l'e-mail du compte de service. Un compte de service devient actif dès que vous enregistrez ; il n'accepte pas l'invitation de lui-même.
2. Sous App permissions, ajoutez chaque app à défendre et activez View financial data et Manage orders and subscriptions.
3. Passez à l'onglet Account permissions (facile à manquer) et, sous Financial data, activez View financial data, orders and cancellation survey responses et Manage orders and subscriptions, puis enregistrez.

Les notifications en temps réel atteignent Refund Sensor via un sujet Pub/Sub que nous créons et branchons pour vous, il n'y a donc rien à coller dans la Play Console. Il faut juste la permission de gérer Pub/Sub. Dans IAM & Admin → IAM, cliquez sur Grant access, collez l'e-mail de votre compte de service comme principal, sélectionnez le rôle Pub/Sub Admin (roles/pubsub.admin) et enregistrez. Choisissez Pub/Sub Admin, pas Pub/Sub Lite Admin ; le rôle Lite ne marche pas et c'est la cause la plus fréquente d'échec de la configuration automatique.

À l'étape Add apps, collez une URL Play Store ou un nom de package par ligne (le nom de package est la valeur après ?id= dans un lien Play Store, par exemple com.yourcompany.app). Refund Sensor valide chacun face à l'accès Play Console du compte connecté avant l'import, et signale ceux qu'il ne peut pas voir.

Avec les API activées et Pub/Sub Admin accordé, importer une app crée automatiquement le sujet et l'abonnement push et l'enregistre comme point de terminaison RTDN de l'app. L'app affiche alors Awaiting first refund event jusqu'à ce que Google livre le premier événement réel (il n'y a pas de bouton de test du côté de Google). Si la configuration automatique échoue, la carte de l'app affiche Real-time notifications not set up avec un lien de retour vers ce guide.

Tous les remboursements Google Play ne peuvent pas être contestés. Un remboursement utilisateur ordinaire est décidé par Google seul, donc ceux-là sont enregistrés pour visibilité mais pas contestés.

Le seul remboursement auquel vous pouvez vraiment répondre est une rétrofacturation en cours d'examen (le pendingRefundReviewNotification de Google). Elle vous donne environ 24 heures et retient la première réponse. Refund Sensor y répond automatiquement par une recommandation de refus, bien avant la fin de la fenêtre.

En filet de sécurité, Refund Sensor rapproche aussi les données avec l'API des achats annulés de Google, si bien que chaque remboursement et achat annulé apparaît dans votre tableau de bord même quand il n'y avait rien à contester.