Google Play Biblioteca de facturación en 2026
Toda app de Android que venda algo —una suscripción, un desbloqueo único, un paquete de monedas— incluye una copia de la Billing Library de Google Play. Esa biblioteca no es para siempre: Google retira cada versión principal con un reloj fijo de dos años, y una vez retirada tu versión, la app sigue funcionando pero ya no puedes publicar actualizaciones. A 31 de agosto de 2026, la versión mínima compatible es Play Billing Library 8, y cada versión que aún se compile con la versión 7 o anterior tiene una única ventana restante: la fecha límite de prórroga del 1 de noviembre de 2026.
Esta es la versión operativa de esa migración: qué dice realmente hoy la tabla de obsolescencia, cómo averiguar qué versión lleva un APK determinado, los cambios exactos de nombre de API que rompen la compilación al pasar de 7 a 8 o 9, dónde se encuentra el formulario de extensión y qué probar antes de publicar la compilación.
Cuatro cifras deciden esta migración: 2 años, el ciclo de obsolescencia aplicado a cada versión principal de Play Billing Library desde que Google anunció la política en el I/O de 2019. 31 de agosto de 2026, la fecha límite para que las apps nuevas y las actualizaciones usen la versión 8 o posterior (es la fecha límite de la v7). 1 de noviembre de 2026, la fecha límite de prórroga para esa misma versión. 8, la versión más baja que Google Play acepta hoy en un nuevo lanzamiento.
1. En qué punto está realmente la fecha límite hoy
El aviso en la propia página de Google sobre la obsolescencia de la versión de Play Billing Library dice: "Antes del 31 de agosto de 2026, todas las apps nuevas y las actualizaciones de apps existentes deben usar la versión 8 o posterior de Billing Library. Si necesitas más tiempo para actualizar tu app, puedes solicitar una prórroga hasta el 1 de noviembre de 2026". Esa frase es toda la regla, y tiene dos mitades que la gente confunde.
La primera mitad es una restricción de publicación, no una retirada: una app que aún lleva una versión retirada sigue funcionando para los usuarios que ya la instalaron, pero Play no aceptará tu nueva versión. Las preguntas frecuentes sobre obsolescencia lo dicen con claridad: los APK sin mantenimiento no necesitan actualizarse, mientras que las apps nuevas y las actualizaciones deben usar una versión compatible. Así que el perfil de riesgo no es "mi app desaparece de la tienda", sino "no puedo publicar la corrección, el nuevo experimento de ficha de la tienda ni la actualización de cumplimiento hasta que esto esté resuelto".
La segunda mitad es la vía de escape: la prórroga. Se solicita desde Play Console y se concede con la misma fecha límite fija, no con una cuenta atrás nueva; por eso, para quien siga en la v7 a finales de septiembre de 2026, la pregunta práctica no es si le queda tiempo, sino si ya ha presentado la prórroga.
2. El calendario de obsolescencia es fijo y se publica con antelación
Google ha publicado la tabla de obsolescencia completa, y conviene leerla como un calendario más que como una advertencia. Cada versión principal tiene una fecha límite de "nueva app y actualización" el 31 de agosto y una fecha límite de prórroga el 1 de noviembre, dos años después:
- Versión 5: nueva fecha límite para apps y actualizaciones el 31 de agosto de 2024; fecha límite de extensión el 1 de noviembre de 2024.
- Versión 6: 31 de agosto de 2025; prórroga el 1 de noviembre de 2025.
- Versión 7: 31 de agosto de 2026; prórroga el 1 de noviembre de 2026.
- Versión 8: 31 de agosto de 2027; prórroga el 1 de noviembre de 2027.
- Versión 9: 31 de agosto de 2028; prórroga el 1 de noviembre de 2028.
Se desprenden dos conclusiones. Primera: una app que ya iba dos versiones por detrás en 2025 ahora va tres por detrás, y hoy supone el mismo trabajo que habría supuesto entonces. Segunda: esto es una partida de mantenimiento permanente, no un proyecto puntual; elijas la versión que elijas esta vez, volverás aquí dentro de dos años. Programar la actualización junto con tu ciclo habitual de versiones sale más barato que reaccionar a una advertencia de Console.
3. Paso 1 — averigua qué incluye realmente tu versión
Empieza por build.gradle. La Biblioteca de Facturación se declara como dependencia en com.android.billingclient:billing, y su cadena de versión es tu respuesta:
dependencies { def billingVersion = "8.3.0" implementation "com.android.billingclient:billing:$billingVersion" }
Las preguntas frecuentes sobre la obsolescencia añaden un detalle importante: estas dependencias solo aparecen en los APK que requieren el permiso com.android.vending.BILLING. En un proyecto multimódulo, o en una cartera donde unas cuantas apps usan un módulo compartido antiguo, la compilación problemática es la que declara la facturación, no necesariamente la app que estás pensando. Audita todos los paquetes que incluyan facturación, no solo aquellos para los que recuerdas haber escrito código de pago.
También hay una comprobación secundaria que explica una advertencia persistente. Play identifica la versión de la biblioteca a partir del atributo com.google.android.play.billingclient.version del AndroidManifest.xml combinado. Si ya has actualizado la dependencia y la consola sigue informando de una versión obsoleta, la indicación oficial es confirmar que ese atributo existe: la combinación de manifiestos es la razón habitual de que falte.
4. Paso 2: elige tu objetivo, versión 8 o versión 9
El requisito es "versión 8 o posterior", lo que significa que tanto 8.x como 9.x lo cumplen. El compromiso es real, así que tómalo de forma deliberada.
- Versión 8 — publicada el 30 de junio de 2025; la línea 8.x terminó con la 8.3.0 el 23 de diciembre de 2025. Es el diff más pequeño, y si tu código está en la v7 los errores de compilación son pocos y mecánicos.
- Versión 9: la 9.0.0 se publicó el 19 de mayo de 2026 y la 9.1.0 el 18 de junio de 2026. Incluye las API más recientes y actualiza
targetSdkVersiona 35, algo que conviene sopesar frente al nivel de API que ya estés gestionando para la política de nivel de API objetivo de Play.
Si también lees esto para planificar el ciclo siguiente: el plazo propio de v8 es el 31 de agosto de 2027, con la prórroga hasta el 1 de noviembre de 2027. Migrar hoy a 9.1.0 te da el mayor margen, y la guía de migración a v9 está pensada para equipos que llegan directamente desde la 7 o la 8.
5. Paso 3 — la migración de v7 a v8 en sí
Según la guía oficial de migración a Play Billing Library 8, la actualización consta de tres pasos más trabajo opcional.
Primer paso: actualizar la dependencia. Apunta com.android.billingclient:billing a la 8.0.0 o posterior (usa el último parche de la línea, no la versión .0, salvo que tengas un motivo).
Segundo cambio: gestiona las APIs de suscripción renombradas. Son las llamadas que rompen la compilación si vienes de PBL 6; los reemplazos son renombrados directos:
setOldSkuPurchaseToken→setOldPurchaseTokensetReplaceProrationMode→setSubscriptionReplacementModesetReplaceSkusProrationMode→setSubscriptionReplacementMode
Tercer paso: corrige queryProductDetailsAsync. Hay un cambio de firma en ProductDetailsResponseListener.onProductDetailsResponse, que requiere cambios de código en tu implementación. El cambio de comportamiento que hay detrás importa más que la firma: antes de 8.0.0, los productos que no se podían obtener simplemente no se devolvían; con PBL 8 vuelven con un nuevo código de estado a nivel de producto que explica el motivo: producto no encontrado o sin ofertas disponibles para ese usuario. Si tu interfaz antes deducía "este usuario no es elegible" del silencio, ahora tiene que leer el estado en lugar de adivinar.
También se eliminaron en PBL 8 si tu código todavía llama a alguno de ellos: queryPurchaseHistoryAsync (usa las alternativas de Consultar el historial de compras), querySkuDetailsAsync (usa queryProductDetailsAsync), el enablePendingPurchases() sin parámetros (usa enablePendingPurchases(PendingPurchaseParams)) y la sobrecarga antigua queryPurchasesAsync(String skuType, PurchasesResponseListener). Quienes estén en la v6 o anterior y pasen directamente a la v8 también tienen que dejar atrás enableAlternativeBilling / AlternativeBillingListener / AlternativeChoiceDetails, sustituidos por enableUserChoiceBilling / UserChoiceBillingListener / UserChoiceDetails.
Opcional, pero recomendable: BillingClient.Builder.enableAutoServiceReconnection() permite que la biblioteca restablezca por sí sola la conexión con el servicio Play Billing en lugar de exigirte llamar de nuevo a startConnection() tras una desconexión, la causa más común de los avisos de "el botón de compra no hace nada" en Android. La misma versión añade compatibilidad con compras pendientes para planes de prepago y suscripciones con pago a plazos virtuales.
6. Paso 4: o ve hasta la 9.1.0
La guía de migración de Play Billing Library 9 abarca a los equipos que vienen de la versión 7 u 8. Más allá de la actualización de la dependencia a 9.1.0, el tema recurrente es que el vocabulario heredado de SKU desaparece por fin (BillingClient.SkuType → ProductType, SkuDetails → ProductDetails, SkuDetailsParams → QueryProductDetailsParams, SkuDetailsResponseListener → ProductDetailsResponseListener, getSkuDetailsList/setSkuDetailsList → setProductDetailsParamsList), y un cambio impacta directamente en la lógica de ingresos por suscripciones:
Si usabas
queryPurchaseHistoryAsyncpara decidir si un usuario cumple los requisitos para una prueba gratuita, la guía indica que usesProductDetails.getSubscriptionOfferDetails()para determinar a qué ofertas es elegible un usuario.
Tres cambios menores de la v9 son fáciles de pasar por alto. La gestión del Play Store bloqueado cambió los códigos de respuesta: cuando la propia app de Play Store está bloqueada (por ejemplo, en los modos infantiles de algunos fabricantes), el código de resultado pasó de ERROR a BILLING_UNAVAILABLE con un mensaje de depuración «Play Store is blocked», y esto requiere androidx.core versión 1.9 o posterior para funcionar correctamente. DeveloperProvidedBillingDetails.getLinkUri() ahora es @Nullable, así que cualquier código que abra ese URI sin comprobar si es nulo o una cadena vacía provoca un fallo seguro. Y la 9.0.0 añade mensajería dentro de la app para los aumentos de precio con aceptación voluntaria, que muestra a los usuarios el aumento pendiente sin salir de la app, con un límite de un mensaje cada siete días.
7. Paso 5 — el formulario de prórroga, si lo necesitas
Si tu app sigue distribuyendo una versión no compatible, Play Console muestra una advertencia. La prórroga se solicita desde la página de detalles de la advertencia: abre Estado de la política, abre la advertencia y usa el formulario de prórroga enlazado allí. Oficialmente, esta es la única vía: no hay solicitud por correo ni una segunda prórroga más allá de la fecha publicada del 1 de noviembre para la versión en cuestión.
Considérelo un margen de entrega dentro de una fecha límite ya fijada, no un plazo adicional. Si presenta la prórroga, el trabajo igual debe estar hecho antes del 1 de noviembre de 2026, y a partir de esa fecha dejan de aceptarse nuevas versiones en v7, incluida la versión de cumplimiento que quizá esté esperando por una política totalmente ajena.
8. Paso 6 — verifica antes de publicar
Las regresiones de facturación no aparecen como fallos; aparecen como usuarios de pago que no pueden comprar. Antes de que la versión llegue a producción:
- Realiza una compra real, una mejora o degradación de suscripción y una restauración, usando testers de licencias en un dispositivo que realmente tenga Play Store instalado; los emuladores que no lo tienen no ponen a prueba el manejo de la conexión que acabas de modificar.
- Confirma que la llamada a los detalles del producto ahora devuelve los productos no obtenidos con sus códigos de estado, y que la interfaz muestra el mensaje correcto para "no encontrado" frente a "ninguna oferta disponible para este usuario".
- Verifica que la advertencia de obsolescencia desaparece en Play Console tras la versión, y que el atributo
com.google.android.play.billingclient.versionestá presente en el manifiesto combinado. - Implementa por fases para que una regresión de facturación llegue a una parte de los usuarios y no a todos, con un código de versión superior listo para sustituirla.
9. Lo que las versiones más recientes devuelven en materia de ingresos
La migración es trabajo facturable, así que es justo valorar lo que desbloquea la biblioteca más reciente. PBL 8.0.0 cambió el nombre de "artículos dentro de la app" a productos de pago único y añadió varias opciones de compra y ofertas para ellos, lo que reduce el número de productos distintos que hay que crear para vender lo mismo a distintos niveles de precio. También añadió códigos de subrespuesta a launchBillingFlow(): PAYMENT_DECLINED_DUE_TO_INSUFFICIENT_FUNDS, USER_INELIGIBLE (el usuario no cumple los requisitos de elegibilidad configurados para una oferta de suscripción) y el valor predeterminado NO_APPLICABLE_SUB_RESPONSE_CODE, la diferencia entre un vago "algo salió mal" y una pantalla que indica al usuario que recargue su tarjeta.
Las versiones 8.2.x y 8.3.0 (diciembre de 2025) añadieron las API de enlaces a contenido externo, ofertas externas y pagos externos, y la 9.1.0 añadió las API de elección de facturación. Si tu hoja de ruta incluye alguno de esos programas, el salto de versión es el requisito previo y no un proyecto aparte, lo que es el argumento práctico para pasar a la 9.1.0 mientras ya estás en este código.
Fuentes
- Obsolescencia de la versión de la Biblioteca de Facturación de Google Play — Desarrolladores de Android
- Migra a la Biblioteca de Facturación de Google Play 8 desde las versiones 6 o 7 — Desarrolladores de Android
- Migra a la Biblioteca de Facturación de Google Play 9 desde las versiones 7 u 8 — Desarrolladores de Android
- Google PlayNotas de la versión de la Biblioteca de facturación: Desarrolladores de Android
- Acerca de las suscripciones — Facturación de Play — Desarrolladores de Android
¿Gestionas cuentas de desarrollador a escala? Nosotros nos encargamos de la parte operativa.
Hemos recibido tu mensaje y responderemos en un plazo de 24 horas.
← Volver a editar