Todos los artículos
Análisis a fondo7 min de lectura

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.

El escritorio de un desarrollador Android con luz de mañana, un portátil, un teléfono y un calendario de pared con una fecha marcada en un círculo, la semana en que Play Billing Library 8 pasó a ser el mínimo para actualizar en Google Play

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 bibliotecaPlazo para apps nuevas y actualizacionesPlazo de la prórroga
631 de agosto de 20251 de noviembre de 2025
731 de agosto de 20261 de noviembre de 2026
831 de agosto de 20271 de noviembre de 2027
931 de agosto de 20281 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 ahoraDónde se ejecuta
Compras activas y pendientesqueryPurchasesAsync()En el dispositivo
Compras únicas consumidasTus propios registrosTu servidor
Compras reembolsadas, canceladas o con contracargoVoided Purchases APITu servidor
El historial completo de compras de un usuarioTus propios registrosTu 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.

Un ingeniero con una tableta en un pasillo silencioso de servidores, donde ahora hay que registrar las compras reembolsadas y consumidas de Google Play después de que Play Billing Library 8 eliminara el historial de compras del cliente

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() y enablePendingPurchases() 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() en onResume() 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 VoidedPurchaseNotification como PendingRefundReviewNotification.
  • 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

RefundHalt

El piloto automático de reembolsos para App Store y Google Play

Seguir leyendo

La próxima solicitud de reembolso ya está en camino.

Configura RefundHalt en el tiempo que tardas en leer otro correo de soporte sobre un reembolso que no llegaste a impugnar.