Tous les articles
Analyse approfondie7 min de lecture

Play Billing Library 8 est désormais obligatoire pour chaque mise à jour sur Google Play et elle déplace le suivi des remboursements sur votre serveur

La prolongation accordée par Google pour Play Billing Library 7 a expiré le 1er novembre 2026, donc les nouvelles applis et les mises à jour doivent utiliser la version 8 ou ultérieure. La version 8 a supprimé queryPurchaseHistory(), ce qui oblige à suivre les achats remboursés et consommés côté serveur. Voici ce qui a changé et ce que coûte une migration trop lente.

Le bureau d'un développeur Android dans la lumière du matin, avec un ordinateur portable, un téléphone et un calendrier mural où une date est entourée, la semaine où Play Billing Library 8 est devenue le minimum pour les mises à jour sur Google Play

Points clés

  • Le tableau d'obsolescence de Google a fixé au 31 août 2026 le dernier jour pour publier de nouvelles applis et des mises à jour avec Play Billing Library 7, et les prolongations ont pris fin le 1er novembre 2026. Toute mise à jour sur Google Play exige donc maintenant Play Billing Library 8 ou ultérieure.
  • Les applis déjà publiées avec Play Billing Library 7 continuent de fonctionner, car Google précise que l'obsolescence ne bloque que les nouvelles applis et les mises à jour, pas les installations existantes.
  • Play Billing Library 8 a supprimé queryPurchaseHistory(), et la solution de remplacement de Google passe par le serveur : suivez les achats consommés sur votre propre backend et récupérez les achats remboursés ou annulés via la Voided Purchases API.
  • La Voided Purchases API de Google Play n'affiche que les achats annulés des 30 derniers jours et autorise 6 000 requêtes par jour et 30 requêtes sur toute période de 30 secondes, par appli.
  • Google Play rembourse toujours automatiquement un achat et retire l'accès si l'appli ne le confirme pas sous trois jours, et une migration ratée vers Play Billing Library 8 peut déclencher cela sur chaque vente.
  • L'examen des rétrofacturations de Google Play est le seul parcours de remboursement Android qui demande des preuves au développeur, via orders.reviewrefund dans les 24 heures qui suivent la PendingRefundReviewNotification.
  • Pour les commandes Google Play passées après le 3 août 2026, le développeur paie le prix d'achat, moins les frais de service de Play, plus les frais bancaires de rétrofacturation, à chaque rétrofacturation perdue.

Toute appli Android qui vend via Google Play doit désormais intégrer Play Billing Library 8 ou ultérieure à sa prochaine mise à jour. L'échéance de la version 7 pour les nouvelles applis et les mises à jour était le 31 août 2026, et les dernières prolongations ont expiré le 1er novembre 2026. Les dates figurent dans un tableau de la FAQ de Google sur l'obsolescence, et les rappels arrivent sous forme d'avertissements sur la page État des règles de Play Console.

Pour la plupart des équipes, il s'agit de mettre à jour une dépendance et de renommer quelques méthodes. Pour les remboursements, c'est plus que ça. Play Billing Library 8 a supprimé le seul appel client qui permettait à une appli de consulter les achats passés. Désormais, si vous voulez savoir ce qu'un utilisateur a acheté, consommé ou s'est fait rembourser, c'est votre serveur qui doit s'en souvenir.

Ce que l'échéance de Play Billing Library 8 bloque vraiment

Google accorde à chaque version de la bibliothèque une durée de vie de deux ans. L'obsolescence ne bloque que les nouvelles applis et les mises à jour. La FAQ de Google indique que les applis existantes fonctionnent toujours et que les APK non maintenus n'ont pas besoin d'être mis à jour. Rien ne casse donc aujourd'hui sur une appli que vous ne touchez plus. Ça casse le jour où vous essayez de publier un correctif, un nouveau prix ou un nouveau paywall.

Version de la bibliothèqueÉchéance pour les nouvelles applis et mises à jourFin de la prolongation
631 août 20251er novembre 2025
731 août 20261er novembre 2026
831 août 20271er novembre 2027
931 août 20281er novembre 2028

La version 8.0.0 est sortie le 30 juin 2025. La version 9.0.0 a suivi le 19 mai 2026. Si vous migrez maintenant, passer directement à la 9 vous donne un an de plus que de vous arrêter à la 8.

Pourquoi Play Billing Library 8 compte pour les remboursements

La suppression majeure, c'est queryPurchaseHistory(). Elle a été rendue obsolète dans la version 7 et supprimée dans la 8.0.0. Les notes de migration de Google répartissent son ancien rôle en trois morceaux, et un seul reste sur l'appareil.

Ce pour quoi vous utilisiez queryPurchaseHistory()Ce que Google recommande maintenantOù ça s'exécute
Achats actifs et en attentequeryPurchasesAsync()Sur l'appareil
Achats ponctuels consommésVos propres enregistrementsVotre serveur
Achats remboursés, annulés ou rétrofacturésVoided Purchases APIVotre serveur
L'historique d'achat complet d'un utilisateurVos propres enregistrementsVotre serveur

Peut-on encore restaurer les achats consommables sur Android ?

Pas depuis le client. queryPurchasesAsync() renvoie ce qui est actif, donc un pack de crédits consommé ou un lot de gemmes épuisé ne revient jamais par ce biais. Si un utilisateur réinstalle et demande où sont passées ses pièces, la réponse doit venir du registre que vous avez tenu au moment de l'achat. Les applis qui comptaient sur l'historique d'achat comme sauvegarde gratuite l'ont perdue.

Comment être informé des remboursements maintenant ?

Par deux canaux côté serveur. Les notifications en temps réel pour les développeurs envoient une VoidedPurchaseNotification avec le jeton d'achat, l'ID de commande, le type de produit et un type de remboursement, soit total, soit partiel selon la quantité. La Voided Purchases API vous permet de récupérer les mêmes événements par plage horaire, en filet de sécurité pour tout ce qui vous aurait échappé.

L'API de récupération a des limites strictes. Elle n'affiche que les achats annulés des 30 derniers jours. Chaque appli dispose de 6 000 requêtes par jour et de 30 requêtes sur toute période de 30 secondes. Et un remboursement effectué par le développeur sans l'option de révocation n'est pas renvoyé du tout. Un serveur en panne pendant cinq semaines perd des remboursements qu'il ne pourra jamais récupérer.

Un ingénieur avec une tablette dans une allée de serveurs silencieuse, là où les achats Google Play remboursés et consommés doivent désormais être enregistrés depuis que Play Billing Library 8 a supprimé l'historique d'achat côté client

Les remboursements sur lesquels le développeur a encore son mot à dire

Déplacer le suivi des remboursements sur le serveur ne vous donne pas plus de contrôle sur eux. Presque tous les remboursements Google Play sont décidés sans vous : remboursements en libre-service, remboursements par le support, annulations et remboursements automatiques des achats non confirmés. Vous l'apprenez après coup, par la notification d'achat annulé.

L'exception, c'est l'examen des rétrofacturations. Quand un acheteur dépose une rétrofacturation qui nécessite votre avis, Google envoie une PendingRefundReviewNotification. Google indique que vous devez répondre avec une suggestion de remboursement et des preuves d'utilisation sous 24 heures en appelant orders.reviewrefund. Ces preuves viennent des mêmes enregistrements serveur que la nouvelle bibliothèque vous oblige à tenir. Une équipe qui tient déjà un registre pour les restaurations a ce qu'il faut pour répondre.

Ce que coûte une migration lente, en argent

Le risque direct, c'est la règle des trois jours. Google Play rembourse automatiquement un achat et retire l'accès si votre appli ne le confirme pas sous trois jours. Pour les achats en attente, le délai commence quand l'achat passe de PENDING à PURCHASED. Une migration qui casse la logique de connexion, le nouveau listener de queryProductDetailsAsync() ou la configuration des achats en attente peut stopper les confirmations sans stopper les ventes. Chaque commande passée dans cet intervalle est remboursée intégralement, et l'utilisateur a déjà reçu ce qu'il a payé.

C'est là que ça fait mal. Un pack de crédits d'images remboursé a quand même consommé le temps GPU de chaque génération. Un abonnement IA remboursé a quand même exécuté les appels d'API payants. Une offre de stockage remboursée a quand même rempli les disques que vous payez. Un pourboire remboursé a quand même été versé à un créateur. Le remboursement rend le chiffre d'affaires à l'acheteur et vous laisse ces factures.

Les rétrofacturations coûtent aussi plus cher. Le centre d'aide de Google indique que, pour les commandes passées après le 3 août 2026, le développeur prend en charge le prix d'achat, moins les frais de service de Play, plus les frais de rétrofacturation de la banque. Google ne continue de payer que ses propres frais de service. Une appli qui ne peut pas répondre à un examen de rétrofacturation sous 24 heures avec de vraies données d'utilisation paie toute la note à chaque fois.

Une checklist de migration qui protège vos revenus

  • Passez la dépendance à Play Billing Library 8 ou 9 et supprimez queryPurchaseHistory(), querySkuDetailsAsync() et enablePendingPurchases() sans argument.
  • Mettez à jour votre listener de queryProductDetailsAsync(). Depuis la version 8, il renvoie aussi les produits qui n'ont pas pu être récupérés, avec un code de statut.
  • Activez enableAutoServiceReconnection() pour qu'une connexion de facturation perdue ne bloque pas le traitement des achats.
  • Appelez queryPurchasesAsync() dans onResume() pour que les achats finalisés pendant que l'appli est fermée soient quand même confirmés dans les trois jours.
  • Enregistrez sur votre serveur chaque jeton d'achat, ID de commande et consommation, rattaché à votre propre ID de compte.
  • Abonnez-vous aux notifications en temps réel pour les développeurs et traitez à la fois VoidedPurchaseNotification et PendingRefundReviewNotification.
  • Lancez une synchronisation quotidienne avec la Voided Purchases API comme filet de sécurité, largement dans la fenêtre de 30 jours et le quota quotidien de 6 000 requêtes.

RefundHalt écoute les notifications d'achat annulé et d'examen de rétrofacturation de Google Play, répond à chaque examen via orders.reviewrefund dans la fenêtre de 24 heures avec vos vraies données d'utilisation, et conserve l'historique des remboursements que votre appli ne peut plus demander à l'appareil.

Questions fréquentes

Dois-je utiliser Play Billing Library 8 maintenant ?
Oui, pour toute nouvelle appli ou mise à jour qui vend via la facturation Google Play. Le tableau d'obsolescence de Google a fixé au 31 août 2026 l'échéance de la version 7, et les prolongations ont pris fin le 1er novembre 2026. Vous pouvez utiliser la version 8 ou la plus récente, la version 9.
Mon appli existante va-t-elle cesser de fonctionner si elle utilise encore Play Billing Library 7 ?
Non. Google indique que les applis existantes fonctionnent toujours et que les APK non maintenus n'ont pas besoin d'être mis à jour. L'obsolescence vous empêche seulement de publier une nouvelle appli ou une mise à jour qui utilise une version non prise en charge.
Qu'est-ce qui a remplacé queryPurchaseHistoryAsync dans Play Billing Library 8 ?
Rien sur l'appareil ne fait le même travail. Google recommande d'utiliser queryPurchasesAsync() pour les achats actifs et en attente, de suivre les achats consommés sur votre propre serveur et d'utiliser la Voided Purchases API pour les achats annulés ou remboursés.
Jusqu'où remonte la Voided Purchases API de Google Play ?
30 jours. Google indique que l'API ne peut afficher que les achats annulés survenus au cours des 30 derniers jours, et elle limite chaque appli à 6 000 requêtes par jour et 30 requêtes sur toute période de 30 secondes.
Google Play rembourse-t-il un achat si mon appli ne le confirme pas ?
Oui. Si un achat n'est pas confirmé sous trois jours, l'utilisateur est automatiquement remboursé et Google Play révoque l'achat. Pour les achats en attente, les trois jours commencent quand l'état passe de PENDING à PURCHASED.

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.