Google Play Billing Library: cómo actualizar la Biblioteca de Facturación a la versión 8 o 9

Si tu app vende productos o suscripciones en Android, tarde o temprano verás en Play Console un aviso que dice que usas una versión obsoleta de la Google Play Billing Library (en español, Biblioteca de Facturación de Google Play). No es un detalle menor: si la versión dejó de tener soporte, Google no acepta apps nuevas ni actualizaciones que la usen. En esta guía verás qué versiones están vigentes, cómo saber cuál usa tu app, cómo actualizar paso a paso en Android nativo, Flutter, Unity o React Native, y qué hacer si la advertencia no desaparece.

Qué es la Google Play Billing Library

Es la biblioteca oficial que conecta tu app con el sistema de pagos de Google Play. Con ella muestras los productos, abres la pantalla de compra, recibes el resultado y confirmas o consumes cada compra. La necesitas si vendes:

• Productos únicos (antes llamados «productos integrados en la app»): monedas, vidas, quitar anuncios, desbloquear una función.
• Suscripciones: planes mensuales o anuales, con pruebas gratis y ofertas.

Si tu app solo muestra anuncios o cobra fuera de Google Play por un servicio físico, no la usas y este aviso no te aplica. Si estás definiendo cómo vas a ganar dinero, repasa antes cómo monetizar una app.

Calendario de versiones de la Biblioteca de Facturación

Google aplica un ciclo de baja de dos años a cada versión principal. Cuando llega la fecha límite, las apps nuevas y las actualizaciones deben usar una versión compatible. Hay además una extensión opcional que se pide desde Play Console y da unos meses más. Este es el calendario oficial publicado en Android Developers:

Versión	Fecha límite para apps nuevas y actualizaciones	Fin de la extensión
6	31 de agosto de 2025	1 de noviembre de 2025
7	31 de agosto de 2026	1 de noviembre de 2026
8	31 de agosto de 2027	1 de noviembre de 2027
9	31 de agosto de 2028	1 de noviembre de 2028

En la práctica, a finales de 2026 la versión mínima útil es la 8 y lo recomendable es saltar directo a la 9, porque te da dos años más de margen. Las apps que ya están publicadas siguen funcionando para quienes las tienen instaladas; el bloqueo afecta a lo que envíes de ahora en adelante.

Es la misma lógica del requisito anual de API: si ya pasaste por eso, mira nuestra guía del nivel de API objetivo en Google Play, porque conviene resolver ambos en la misma versión.

Cómo saber qué versión de la Billing Library usa tu app

Tienes tres formas de comprobarlo:

1. Play Console: si usas una versión no admitida, aparece una advertencia. Abre Política y programas > Estado con respecto a las políticas y entra al detalle; ahí se indica el problema y, cuando aplica, el formulario de extensión.
2. build.gradle: busca la dependencia com.android.billingclient:billing (o billing-ktx). El número después de los dos puntos es la versión.
3. Dependencias transitivas: si usas un plugin o SDK de pagos, la biblioteca puede llegar «por dentro». Ejecuta ./gradlew app:dependencies y busca billingclient en el resultado para ver la versión real que entra en el paquete.

Un detalle útil de la documentación: la dependencia solo aparece en los APK o AAB que piden el permiso com.android.vending.BILLING, que la propia biblioteca agrega al manifiesto.

Cómo actualizar la Google Play Billing Library paso a paso

1. Cambia la dependencia

En el build.gradle del módulo de la app, sube la versión. Para la 9, la guía oficial de migración muestra:

dependencies {
    def billing_version = "9.1.0"
    implementation "com.android.billingclient:billing:$billing_version"
}

Si usas Kotlin con corrutinas, actualiza también billing-ktx a la misma versión.

2. Revisa los requisitos de SDK

Desde la versión 8.1.0, la biblioteca exige minSdkVersion 23, y la 9.0.0 actualizó su targetSdkVersion a 35. Si tu app todavía admite Android 5 (un minSdk menor que 23), tendrás que subirlo.

3. Reemplaza las APIs eliminadas

La versión 8 quitó métodos que llevaban tiempo marcados como obsoletos. Si tu código los usa, no compilará:

API eliminada	Qué usar en su lugar
querySkuDetailsAsync()	queryProductDetailsAsync()
enablePendingPurchases() sin parámetros	enablePendingPurchases(PendingPurchasesParams) con enableOneTimeProducts()
queryPurchasesAsync(String skuType, …)	queryPurchasesAsync(QueryPurchasesParams, …)
queryPurchaseHistoryAsync()	queryPurchasesAsync() para compras activas y tu servidor para el historial consumido
setOldSkuPurchaseToken	setOldPurchaseToken

4. Ajusta la respuesta de productos

En la versión 8 cambió la firma de onProductDetailsResponse: ahora los productos que no se pudieron recuperar vuelven con un código de estado propio, en lugar de desaparecer sin aviso. Actualiza ese listener y aprovecha para registrar qué productos fallan y por qué.

5. Activa la reconexión automática (recomendado)

Con enableAutoServiceReconnection() en el BillingClient.Builder, la biblioteca intenta reconectarse sola al servicio de facturación cuando se pierde la conexión, sin que tengas que llamar de nuevo a startConnection() a mano.

6. Prueba las compras antes de publicar

Sube la nueva versión a un segmento de prueba y compra con cuentas de verificador de licencias, que no generan cargos reales. Te explicamos cómo configurarlas en license testing en Google Play. Revisa al menos: compra nueva, compra pendiente, restaurar compras al reinstalar y, si tienes suscripciones, cambio de plan.

7. Publica y retira las versiones viejas

Lanza la actualización a producción como cualquier otra; si tienes dudas, sigue nuestra guía para actualizar una app en Google Play. Revisa también los segmentos de prueba: un APK antiguo activo en prueba interna o cerrada puede seguir disparando la advertencia.

Si usas Flutter, Unity o React Native

No editas la biblioteca directamente: la trae tu plugin. El trabajo consiste en actualizar el plugin a una versión que ya incluya la Billing Library 8 o 9 y leer su changelog:

• Flutter: actualiza in_app_purchase y su implementación in_app_purchase_android. Su registro de cambios indica cuándo pasaron a la Billing Library 9 y que esa versión exige minSdk 23.
• Unity: actualiza el paquete de compras dentro de la app que uses y confirma en sus notas qué versión de la biblioteca incluye.
• React Native o SDK de terceros: actualiza la librería de pagos (o el SDK de suscripciones) y verifica la versión real con ./gradlew app:dependencies.

Después de actualizar, genera el AAB de nuevo; no basta con cambiar el número en pubspec.yaml o package.json si no recompilas.

La advertencia no desaparece aunque ya actualicé

Si ya subiste la versión nueva y el aviso sigue ahí, revisa en este orden:

• Manifiesto final: la documentación pide comprobar que el AndroidManifest.xml fusionado contenga com.google.android.play.billingclient.version. Si una regla de fusión (tools:node="remove" o similar) lo elimina, Play Console no detecta la versión nueva.
• Versiones activas en otros segmentos: un bundle viejo en prueba interna, cerrada o abierta sigue contando.
• Dependencia duplicada: un SDK puede forzar una versión anterior. Revisa el árbol de dependencias y resuelve el conflicto.
• Revisión pendiente: mientras la versión corregida siga en revisión o sin publicar, la versión vieja es la que está activa.

Preguntas frecuentes

¿Qué pasa si no actualizo la Billing Library?

Tu app publicada sigue funcionando, pero Google Play no acepta actualizaciones ni apps nuevas con una versión vencida. Quedas bloqueado justo cuando necesites corregir un error.

¿Puedo pedir más tiempo?

Sí, mientras la extensión esté vigente. El formulario está en la página de detalle de la advertencia, dentro de Estado con respecto a las políticas. Para la versión 7, la extensión termina el 1 de noviembre de 2026.

¿Me conviene pasar a la versión 8 o a la 9?

La 8 cumple hasta agosto de 2027; la 9 hasta agosto de 2028. Si ya vas a tocar el código, la 9 te ahorra repetir la migración el próximo año.

¿Es lo mismo «google play billing library version 7.0.0 or later» que este aviso?

Es el mismo tipo de aviso de años anteriores, cuando el mínimo era la versión 7. Hoy el mínimo para enviar actualizaciones es la 8.

¿Afecta a apps que solo tienen anuncios?

No. Solo aplica si tu app usa la Biblioteca de Facturación para vender productos o suscripciones.

Prepara tu ficha mientras actualizas, con AppConsol

Si vas a publicar una versión nueva, aprovecha para renovar tu ficha: crea capturas listas para Play Store con el generador de screenshots para Google Play y asegúrate de que tu política de privacidad mencione los pagos con el generador de política de privacidad. Prueba AppConsol gratis en appconsol.com y publica tu actualización sin sorpresas.