KappS Base de connaissances · Blog

Google Play Bibliothèque de facturation en 2026

Blog Guide

Chaque application Android qui vend quoi que ce soit — un abonnement, un déverrouillage ponctuel, un pack de pièces — embarque une copie de la Billing Library de Google Play. Cette bibliothèque n’est pas éternelle : Google retire chaque version majeure selon un calendrier fixe de deux ans, et une fois votre version retirée, l’application fonctionne toujours mais vous ne pouvez plus publier de mises à jour. Au 31 août 2026, la version minimale prise en charge est Play Billing Library 8, et chaque version encore compilée sur la version 7 ou antérieure dispose d’une seule fenêtre restante : l’échéance de prolongation du 1er novembre 2026.

Voici la version opérationnelle de cette migration : ce que dit réellement aujourd’hui le tableau de dépréciation, comment savoir quelle version embarque un APK donné, les renommages d’API exacts qui cassent la compilation quand vous passez de 7 à 8 ou 9, où se trouve le formulaire d’extension et ce qu’il faut tester avant de livrer le build.

Quatre chiffres décident de cette migration : 2 ans — le cycle de dépréciation appliqué à chaque version majeure de la Play Billing Library depuis que Google a annoncé la politique à l'I/O 2019. 31 août 2026 — la date à laquelle les nouvelles applications et mises à jour doivent utiliser la version 8 ou ultérieure (c'est l'échéance de la v7). 1er novembre 2026 — l'échéance d'extension pour la même version. 8 — la version la plus basse que Google Play accepte aujourd'hui dans une nouvelle version.

1. Où en est réellement l'échéance aujourd'hui

La bannière de la page Google consacrée à la dépréciation de la version de la Play Billing Library indique : « D’ici le 31 août 2026, toutes les nouvelles applications et mises à jour d’applications existantes doivent utiliser la version 8 ou ultérieure de la Billing Library. Si vous avez besoin de plus de temps pour mettre à jour votre application, vous pouvez demander une prolongation jusqu’au 1er novembre 2026. » Cette phrase constitue toute la règle, et elle comporte deux volets que l’on confond souvent.

La première moitié est une restriction de publication, pas un retrait : une application qui embarque encore une version retirée continue de fonctionner pour les utilisateurs qui l’ont déjà installée, mais Play n’acceptera pas votre nouvelle version. La FAQ sur la dépréciation énonce clairement le corollaire — les APK non maintenus n’ont pas besoin d’être mis à jour, tandis que les nouvelles applications et les mises à jour doivent utiliser une version prise en charge. Le profil de risque n’est donc pas « mon application disparaît du store ». Il est « je ne peux pas publier le correctif, la nouvelle expérimentation de fiche App Store ou la mise à jour de conformité tant que ce n’est pas réglé ».

La seconde moitié constitue la porte de sortie : la prolongation. Elle se demande depuis la Play Console et s’accorde sur la même date butoir fixe, sans nouveau compte à rebours — la vraie question pour ceux qui sont encore en v7 fin septembre 2026 n’est donc pas de savoir s’ils ont le temps, mais si la prolongation a déjà été déposée.

2. Le compte à rebours de dépréciation est fixe et publié à l’avance

Google a publié le tableau complet de dépréciation, et il vaut la peine de le lire comme un calendrier plutôt que comme un avertissement. Chaque version majeure reçoit une échéance « nouvelle app et mise à jour » au 31 août et une échéance de prolongation au 1er novembre, deux ans plus tard :

  • Version 5 — nouvelle échéance pour les applications et mises à jour : 31 août 2024 ; échéance de prolongation : 1er novembre 2024.
  • Version 6 — 31 août 2025 ; prolongation au 1er novembre 2025.
  • Version 7 — 31 août 2026 ; prolongation au 1er novembre 2026.
  • Version 8 — 31 août 2027 ; prolongation au 1er novembre 2027.
  • Version 9 — 31 août 2028 ; prolongation au 1er novembre 2028.

Deux conclusions s’imposent. Premièrement, une application qui avait déjà deux versions de retard en 2025 en a désormais trois, et le travail à fournir aujourd’hui est le même qu’il l’aurait été alors. Deuxièmement, il s’agit d’un poste de maintenance permanent, pas d’un projet ponctuel : quelle que soit la version choisie cette fois, vous reviendrez ici dans moins de deux ans. Planifier la mise à niveau avec votre cycle de publication habituel coûte moins cher que de réagir à un avertissement de la Console.

3. Étape 1 — déterminer ce que votre version embarque réellement

Commencez par build.gradle. La bibliothèque de facturation est déclarée comme dépendance sur com.android.billingclient:billing, et sa chaîne de version vous donne la réponse :

dependencies { def billingVersion = "8.3.0" implementation "com.android.billingclient:billing:$billingVersion" }

La FAQ sur la dépréciation ajoute un détail important : ces dépendances n’apparaissent que dans les APK qui requièrent l’autorisation com.android.vending.BILLING. Dans un projet multi-modules, ou dans un portefeuille où quelques applications utilisent un ancien module partagé, le build fautif est celui qui déclare la facturation — pas nécessairement l’application à laquelle vous pensez. Auditez chaque bundle qui embarque la facturation, pas seulement ceux pour lesquels vous vous souvenez avoir écrit du code de paiement.

Il existe aussi une vérification de second niveau qui explique un avertissement persistant. Play identifie la version de la bibliothèque à partir de l’attribut com.google.android.play.billingclient.version dans le fichier AndroidManifest.xml fusionné. Si vous avez déjà mis à niveau la dépendance et que la Console signale encore une version dépréciée, la recommandation officielle est de confirmer que cet attribut existe — la fusion des manifestes est la raison habituelle de son absence.

4. Étape 2 — choisissez votre cible : version 8 ou version 9

L’exigence est « version 8 ou ultérieure », ce qui signifie que 8.x et 9.x la satisfont toutes deux. Le compromis est réel, faites-le donc en connaissance de cause.

  • Version 8 — publiée le 30 juin 2025 ; la branche 8.x s'est achevée avec la 8.3.0 le 23 décembre 2025. C'est le diff le plus léger, et si votre code est en v7, les erreurs de compilation sont peu nombreuses et mécaniques.
  • Version 9 — 9.0.0 publiée le 19 mai 2026 et 9.1.0 publiée le 18 juin 2026. API les plus récentes, et elle met à jour targetSdkVersion vers 35, ce qui mérite d'être pesé face à l'exigence de niveau d'API que vous gérez déjà pour la politique de niveau d'API cible de Play.

Si vous lisez aussi ceci pour planifier le cycle suivant : la propre échéance de la v8 est le 31 août 2027, avec une prolongation au 1er novembre 2027. Migrer vers 9.1.0 dès aujourd’hui vous offre la plus longue marge, et le guide de migration v9 est conçu pour les équipes qui arrivent directement de la 7 ou de la 8.

5. Étape 3 — la migration v7 → v8 à proprement parler

Selon le guide de migration officiel pour Play Billing Library 8, la mise à niveau se fait en trois étapes plus des travaux optionnels.

Première étape : mettre à jour la dépendance. Pointez com.android.billingclient:billing vers 8.0.0 ou une version ultérieure (utilisez le dernier correctif de la branche, pas la version .0, sauf raison particulière).

Deuxième étape : gérez le renommage des API d’abonnement. Ce sont les appels qui cassent la compilation quand vous venez de PBL 6 ; les alternatives sont des renommages directs :

  • setOldSkuPurchaseToken → setOldPurchaseToken
  • setReplaceProrationMode → setSubscriptionReplacementMode
  • setReplaceSkusProrationMode → setSubscriptionReplacementMode

Troisième étape : corrigez queryProductDetailsAsync. La signature de ProductDetailsResponseListener.onProductDetailsResponse change, ce qui impose des modifications de code dans votre implémentation. Le changement de comportement qui la sous-tend compte plus que la signature : avant 8.0.0, les produits qui ne pouvaient pas être récupérés n'étaient tout simplement pas renvoyés ; avec PBL 8, ils reviennent avec un nouveau code de statut au niveau du produit qui explique pourquoi — produit introuvable ou aucune offre disponible pour cet utilisateur. Si votre interface déduisait auparavant « cet utilisateur n'est pas éligible » à partir du silence, elle doit désormais lire le statut au lieu de deviner.

Également supprimés dans PBL 8 si votre code en appelle encore : queryPurchaseHistoryAsync (utilisez les alternatives dans Query Purchase History), querySkuDetailsAsync (utilisez queryProductDetailsAsync), enablePendingPurchases() sans paramètre (utilisez enablePendingPurchases(PendingPurchaseParams)) et l’ancienne surcharge queryPurchasesAsync(String skuType, PurchasesResponseListener). Les lecteurs en v6 ou antérieure qui passent directement en v8 doivent aussi abandonner enableAlternativeBilling / AlternativeBillingListener / AlternativeChoiceDetails, remplacés par enableUserChoiceBilling / UserChoiceBillingListener / UserChoiceDetails.

Facultatif, mais à activer : BillingClient.Builder.enableAutoServiceReconnection() permet à la bibliothèque de rétablir d’elle-même la connexion au service Play Billing au lieu de vous obliger à rappeler startConnection() après une déconnexion — la cause la plus fréquente des signalements « le bouton d’achat ne fait rien » sur Android. La même version ajoute la prise en charge des achats en attente pour les forfaits prépayés et les abonnements à paiement échelonné virtuel.

6. Étape 4 — ou passez directement à la 9.1.0

Le guide de migration pour Play Billing Library 9 s’adresse aux équipes qui passent de la version 7 ou 8. Au-delà de la mise à jour de dépendance vers 9.1.0, le fil rouge est la disparition définitive du vocabulaire SKU hérité (BillingClient.SkuType → ProductType, SkuDetails → ProductDetails, SkuDetailsParams → QueryProductDetailsParams, SkuDetailsResponseListener → ProductDetailsResponseListener, getSkuDetailsList/setSkuDetailsList → setProductDetailsParamsList), et un changement touche directement la logique de revenus des abonnements :

Si vous utilisiez queryPurchaseHistoryAsync pour déterminer si un utilisateur est éligible à un essai gratuit, le guide indique d’utiliser ProductDetails.getSubscriptionOfferDetails() pour déterminer à quelles offres un utilisateur est éligible.

Trois changements plus discrets de la v9 sont faciles à manquer. La gestion du Play Store bloqué a changé de codes de réponse : lorsque l’application Play Store elle-même est bloquée (modes enfants de certains OEM, par exemple), le code de résultat passe de ERROR à BILLING_UNAVAILABLE avec un message de débogage « Play Store is blocked », et cela nécessite androidx.core version 1.9 ou ultérieure pour fonctionner correctement. DeveloperProvidedBillingDetails.getLinkUri() est désormais @Nullable, donc tout code qui lance cette URI sans vérifier la nullité et la chaîne vide provoque un plantage immédiat. Et la 9.0.0 ajoute la messagerie in-app pour les hausses de prix avec opt-in, qui montre aux utilisateurs la hausse en attente sans quitter l’application — limitée à un message tous les sept jours.

7. Étape 5 — le formulaire de prolongation, si vous en avez besoin

Si votre application diffuse encore une version non prise en charge, la Play Console affiche un avertissement. La prolongation se demande depuis la page de détails de l’avertissement : ouvrez Statut de la politique, ouvrez l’avertissement et utilisez le formulaire de prolongation qui y est lié. Officiellement, c’est la seule voie — aucune demande par e-mail, et aucune seconde prolongation au-delà de la date publiée du 1er novembre pour la version concernée.

Considérez-la comme une marge de sécurité dans une échéance déjà fixée, pas comme un délai supplémentaire. Si vous déposez la prolongation, le travail doit quand même être fait avant le 1er novembre 2026, et après cette date, les nouvelles versions sur v7 ne sont plus acceptées — y compris la version de conformité que vous attendiez peut-être pour une politique totalement différente.

8. Étape 6 — vérifier avant de livrer

Les régressions de facturation ne se manifestent pas par des plantages ; elles se manifestent par des utilisateurs payants qui ne peuvent plus acheter. Avant la mise en production :

  • Effectuez un achat réel, une montée ou descente de gamme d’abonnement, et une restauration, avec des testeurs sous licence sur un appareil sur lequel le Play Store est réellement installé — les émulateurs sans Play Store ne testent pas la gestion de connexion que vous venez de modifier.
  • Vérifiez que l’appel aux détails du produit renvoie désormais les produits non récupérés avec leurs codes de statut, et que l’interface affiche le bon message selon qu’il s’agit de « introuvable » ou d’« aucune offre disponible pour cet utilisateur ».
  • Vérifiez que l’avertissement de dépréciation disparaît dans Play Console après la publication, et que l’attribut com.google.android.play.billingclient.version est présent dans le manifeste fusionné.
  • Déployez par étapes afin qu'une régression de facturation n'atteigne qu'une fraction des utilisateurs plutôt que tous, avec un code de version supérieur prêt à la remplacer.

9. Ce que les versions plus récentes rapportent côté revenus

La migration est un travail facturable, il est donc légitime de compter ce que la bibliothèque plus récente apporte. PBL 8.0.0 a renommé les « articles intégrés » en produits ponctuels et y a ajouté plusieurs options d’achat et offres, ce qui réduit le nombre de produits distincts à créer pour vendre la même chose à des paliers de prix différents. Elle a aussi ajouté des codes de sous-réponse à launchBillingFlow() : PAYMENT_DECLINED_DUE_TO_INSUFFICIENT_FUNDS, USER_INELIGIBLE (l’utilisateur ne remplit pas les critères d’éligibilité configurés pour une offre d’abonnement) et le code par défaut NO_APPLICABLE_SUB_RESPONSE_CODE — la différence entre un vague « une erreur s’est produite » et un écran qui invite l’utilisateur à recharger sa carte.

Les versions 8.2.x et 8.3.0 (décembre 2025) ont ajouté les API de liens vers du contenu externe, d’offres externes et de paiements externes, et la 9.1.0 a ajouté les API Billing Choice. Si votre feuille de route inclut l’un de ces programmes, le saut de version en est le prérequis plutôt qu’un projet distinct — c’est l’argument pratique pour passer à la 9.1.0 tant que vous êtes déjà dans ce code.


Vous gérez des comptes développeur à grande échelle ? Nous prenons en charge le volet opérationnel.

Cliquez pour choisir un fichier · clic droit → Coller, ou appuyez sur Ctrl/⌘+V pour coller une capture d’écran

Vous pouvez aussi glisser un fichier sur cette zone.

Nous répondons à l’e-mail que vous indiquez. Vos données restent chez KappS.

✔ Soumis

Nous avons bien reçu votre message et vous répondrons sous 24 heures.


← Retour à la modification