Play Billing Library 8 ya es obligatoria para cada actualización en Google Play y lleva el seguimiento de reembolsos a tu servidor
La prórroga de Google para Play Billing Library 7 venció el 1 de noviembre de 2026, así que las apps nuevas y las actualizaciones necesitan la versión 8 o posterior. La versión 8 eliminó queryPurchaseHistory(), por lo que las compras reembolsadas y consumidas deben registrarse en el servidor. Esto es lo que cambió y lo que cuesta una migración lenta.

Puntos clave
- La tabla de obsolescencia de Google fijó el 31 de agosto de 2026 como último día para publicar apps nuevas y actualizaciones con Play Billing Library 7, y las prórrogas terminaron el 1 de noviembre de 2026. Cualquier actualización en Google Play necesita ahora Play Billing Library 8 o posterior.
- Las apps que ya están publicadas con Play Billing Library 7 siguen funcionando, porque Google dice que la obsolescencia solo bloquea apps nuevas y actualizaciones, no las instalaciones existentes.
- Play Billing Library 8 eliminó queryPurchaseHistory(), y el reemplazo que propone Google es en el servidor: registra las compras consumidas en tu propio backend y obtén las reembolsadas o canceladas desde la Voided Purchases API.
- La Voided Purchases API de Google Play solo muestra compras anuladas de los últimos 30 días y permite 6.000 consultas al día y 30 consultas en cualquier período de 30 segundos por app.
- Google Play sigue reembolsando automáticamente una compra y revocando el acceso si la app no la confirma en tres días, y una migración fallida a Play Billing Library 8 puede provocarlo en cada venta.
- La revisión de contracargos de Google Play es el único flujo de reembolso en Android que pide pruebas al desarrollador, mediante orders.reviewrefund en las 24 horas siguientes a la PendingRefundReviewNotification.
- Para pedidos de Google Play hechos después del 3 de agosto de 2026, el desarrollador paga el precio de compra, menos la comisión de servicio de Play, más las comisiones del banco por cada contracargo perdido.
Toda app Android que vende a través de Google Play tiene que incluir ahora Play Billing Library 8 o posterior en su próxima actualización. El plazo de la versión 7 para apps nuevas y actualizaciones fue el 31 de agosto de 2026, y las últimas prórrogas vencieron el 1 de noviembre de 2026. Las fechas están en una tabla de las preguntas frecuentes de Google sobre obsolescencia, y los avisos llegan como advertencias en la página de estado de políticas de Play Console.
Para la mayoría de los equipos es subir una dependencia y cambiar el nombre de algunos métodos. Para los reembolsos, es algo más. Play Billing Library 8 eliminó la única llamada del cliente que permitía a una app revisar compras pasadas. A partir de ahora, si quieres saber qué compró, consumió o se reembolsó un usuario, tu servidor tiene que recordarlo.
Qué bloquea realmente el plazo de Play Billing Library 8
Google da a cada versión de la biblioteca dos años de vida. La obsolescencia solo frena apps nuevas y actualizaciones. Las preguntas frecuentes de Google dicen que las apps existentes siguen funcionando y que los APK sin mantenimiento no necesitan actualizarse. Así que hoy no se rompe nada en una app que ya no tocas. Se rompe el día que intentas publicar una corrección, un precio nuevo o un paywall nuevo.
| Versión de la biblioteca | Plazo para apps nuevas y actualizaciones | Plazo de la prórroga |
|---|---|---|
| 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 |
La versión 8.0.0 salió el 30 de junio de 2025. La versión 9.0.0 llegó el 19 de mayo de 2026. Si migras ahora, pasar directamente a la 9 te da un año más que quedarte en la 8.
Por qué Play Billing Library 8 importa para los reembolsos
La eliminación principal es queryPurchaseHistory(). Quedó obsoleta en la versión 7 y se eliminó en la 8.0.0. Las notas de migración de Google reparten su antigua función en tres partes, y solo una se queda en el dispositivo.
| Para qué usabas queryPurchaseHistory() | Qué dice Google que uses ahora | Dónde se ejecuta |
|---|---|---|
| Compras activas y pendientes | queryPurchasesAsync() | En el dispositivo |
| Compras únicas consumidas | Tus propios registros | Tu servidor |
| Compras reembolsadas, canceladas o con contracargo | Voided Purchases API | Tu servidor |
| El historial completo de compras de un usuario | Tus propios registros | Tu servidor |
¿Todavía puedo restaurar compras consumibles en Android?
No desde el cliente. queryPurchasesAsync() devuelve lo que está activo, así que un paquete de créditos consumido o un lote de gemas ya gastado nunca vuelve por ahí. Si un usuario reinstala y pregunta dónde están sus monedas, la respuesta tiene que salir del registro que guardaste cuando se hizo la compra. Las apps que usaban el historial de compras como copia de seguridad gratuita la han perdido.
¿Cómo me entero ahora de los reembolsos?
Por dos canales en el servidor. Las notificaciones para desarrolladores en tiempo real envían una VoidedPurchaseNotification con el token de compra, el ID del pedido, el tipo de producto y un tipo de reembolso que es total o parcial por cantidad. La Voided Purchases API te permite obtener los mismos eventos por rango de tiempo, como respaldo para lo que se te haya escapado.
La API de consulta tiene límites estrictos. Solo muestra compras anuladas de los últimos 30 días. Cada app tiene 6.000 consultas al día y 30 consultas en cualquier período de 30 segundos. Y un reembolso del desarrollador hecho sin la opción de revocar no aparece en absoluto. Un servidor caído durante cinco semanas pierde reembolsos que nunca podrá recuperar.

En qué reembolsos el desarrollador todavía tiene voz
Llevar el seguimiento de reembolsos al servidor no te da más control sobre ellos. Casi todos los reembolsos de Google Play se deciden sin ti: reembolsos por autoservicio, reembolsos de soporte, cancelaciones y reembolsos automáticos de compras no confirmadas. Te enteras después, por la notificación de compra anulada.
La excepción es la revisión de contracargos. Cuando un comprador presenta un contracargo que necesita tu opinión, Google envía una PendingRefundReviewNotification. Google dice que debes responder con una sugerencia de reembolso y pruebas de uso en 24 horas llamando a orders.reviewrefund. Esas pruebas salen de los mismos registros del servidor que la nueva biblioteca te obliga a guardar. Un equipo que ya lleva un registro para las restauraciones tiene lo que necesita para responder.
Lo que cuesta en dinero una migración lenta
El riesgo directo es la regla de los tres días. Google Play reembolsa automáticamente una compra y revoca el acceso si tu app no la confirma en tres días. En las compras pendientes, el plazo empieza cuando la compra pasa de PENDING a PURCHASED. Una migración que rompe la lógica de conexión, el nuevo listener de queryProductDetailsAsync() o la configuración de compras pendientes puede detener las confirmaciones sin detener las ventas. Cada pedido en ese intervalo se reembolsa por completo, y el usuario ya recibió lo que pagó.
Ahí es donde duele. Un paquete de créditos de imágenes reembolsado ya consumió el tiempo de GPU de cada generación. Un plan de IA reembolsado ya hizo las llamadas de API de pago. Un nivel de almacenamiento reembolsado ya llenó los discos que pagas. Una propina reembolsada ya salió en el pago a un creador. El reembolso devuelve los ingresos al comprador y te deja esas facturas a ti.
Los contracargos también se encarecieron. El centro de ayuda de Google dice que, para pedidos hechos después del 3 de agosto de 2026, el desarrollador cubre el precio de compra, menos la comisión de servicio de Play, más las comisiones de contracargo del banco. Google solo sigue pagando su propia comisión de servicio. Una app que no puede responder una revisión de contracargo en 24 horas con datos de uso reales paga esa factura entera cada vez.
Una lista de verificación de migración que protege los ingresos
- Sube la dependencia a Play Billing Library 8 o 9 y elimina
queryPurchaseHistory(),querySkuDetailsAsync()yenablePendingPurchases()sin argumentos. - Actualiza tu listener de
queryProductDetailsAsync(). Desde la versión 8 también devuelve los productos que no se pudieron obtener, con un código de estado. - Activa
enableAutoServiceReconnection()para que una conexión de facturación caída no detenga el procesamiento de compras. - Llama a
queryPurchasesAsync()enonResume()para que las compras que se completan con la app cerrada se confirmen igualmente dentro de los tres días. - Registra en tu servidor cada token de compra, ID de pedido y consumo, vinculado a tu propio ID de cuenta.
- Suscríbete a las notificaciones para desarrolladores en tiempo real y gestiona tanto
VoidedPurchaseNotificationcomoPendingRefundReviewNotification. - Ejecuta una sincronización diaria con la Voided Purchases API como red de seguridad, muy dentro de la ventana de 30 días y de la cuota diaria de 6.000 consultas.
RefundHalt escucha las notificaciones de compras anuladas y de revisión de contracargos de Google Play, responde cada revisión mediante orders.reviewrefund dentro de la ventana de 24 horas con tus datos de uso reales y guarda el historial de reembolsos que tu app ya no puede pedirle al dispositivo.
Preguntas frecuentes
- ¿Tengo que usar Play Billing Library 8 ahora?
- Sí, para cualquier app nueva o actualización que venda con la facturación de Google Play. La tabla de obsolescencia de Google fijó el 31 de agosto de 2026 como plazo para la versión 7, y las prórrogas terminaron el 1 de noviembre de 2026. Puedes usar la versión 8 o la más reciente, la 9.
- ¿Mi app existente dejará de funcionar si sigue usando Play Billing Library 7?
- No. Google dice que las apps existentes siguen funcionando y que los APK sin mantenimiento no necesitan actualizarse. La obsolescencia solo te impide publicar una app nueva o una actualización que use una versión sin soporte.
- ¿Qué reemplazó a queryPurchaseHistoryAsync en Play Billing Library 8?
- Nada en el dispositivo hace lo mismo. Google dice que uses queryPurchasesAsync() para las compras activas y pendientes, que registres las compras consumidas en tu propio servidor y que uses la Voided Purchases API para las compras canceladas o reembolsadas.
- ¿Hasta cuándo llega hacia atrás la Voided Purchases API de Google Play?
- 30 días. Google dice que la API solo puede mostrar compras anuladas ocurridas en los últimos 30 días, y limita cada app a 6.000 consultas al día y 30 consultas en cualquier período de 30 segundos.
- ¿Google Play reembolsa una compra si mi app no la confirma?
- Sí. Si una compra no se confirma en tres días, el usuario recibe un reembolso automático y Google Play revoca la compra. En las compras pendientes, los tres días empiezan cuando el estado cambia de PENDING a PURCHASED.
Fuentes y lecturas adicionales
- Android Developers: Play Billing Library deprecation FAQ
- Android Developers: Play Billing Library release notes
- Android Developers: Migrate to Play Billing Library 8
- Android Developers: Query purchase history alternatives
- Android Developers: Integrate the Google Play Billing Library into your app
- Android Developers: Real-time developer notifications reference
- Google Play Developer API: Voided Purchases API
- Play Console Help: Chargeback cost sharing for orders after August 3, 2026
RefundHalt
El piloto automático de reembolsos para App Store y Google Play
Seguir leyendo
Brasil ya vigila qué juegos siguen vendiendo cajas de botín a menores, y la factura llega con los reembolsos de cajas de botín
El ministerio de justicia de Brasil pidió a la autoridad de protección de datos que vigile seis juegos que venden cajas de botín sin verificar la edad. Esto es lo que exige la ley, lo que Apple y Google ya piden y cómo valorar y gestionar los reembolsos de cajas de botín cuando la caja ya está abierta.
Las compras in-app accidentales son los reembolsos que no puedes ganar, así que la solución está en tu pantalla de compra
Las compras in-app accidentales vuelven como reembolsos en ambas tiendas, y ningún dato de uso demuestra que un toque fuera intencionado. Así las etiquetan Apple y Google, esto es lo que cada una te cuesta en cómputo y pagos, y este es el diseño de pantalla de compra que las frena antes de que exista el cargo.