Все статьи
Подробный разбор7 мин чтения

Play Billing Library 8 теперь обязательна для каждого обновления в Google Play и переносит учёт возвратов на ваш сервер

Продление, которое Google давал для Play Billing Library 7, закончилось 1 ноября 2026 года, поэтому новым приложениям и обновлениям нужна версия 8 или новее. В версии 8 удалён queryPurchaseHistory(), и теперь возвращённые и израсходованные покупки нужно учитывать на сервере. Разбираем, что изменилось и во что обходится медленная миграция.

Рабочий стол Android-разработчика в утреннем свете с ноутбуком, телефоном и настенным календарём с обведённой датой, в ту неделю, когда Play Billing Library 8 стала минимальной версией для обновлений в Google Play

Главное

  • В таблице прекращения поддержки Google последним днём для новых приложений и обновлений на Play Billing Library 7 указано 31 августа 2026 года, а продления закончились 1 ноября 2026 года. Любому обновлению в Google Play теперь нужна Play Billing Library 8 или новее.
  • Приложения, уже опубликованные с Play Billing Library 7, продолжают работать. По словам Google, прекращение поддержки блокирует только новые приложения и обновления, а не существующие установки.
  • В Play Billing Library 8 удалён queryPurchaseHistory(), и замена, которую предлагает Google, работает на сервере: учитывайте израсходованные покупки в своём бэкенде, а возвращённые или отменённые получайте через Voided Purchases API.
  • Google Play Voided Purchases API показывает только аннулированные покупки за последние 30 дней и разрешает каждому приложению 6000 запросов в день и 30 запросов за любые 30 секунд.
  • Google Play по-прежнему автоматически возвращает деньги за покупку и отзывает доступ, если приложение не подтвердило её в течение трёх дней. Неудачная миграция на Play Billing Library 8 может запустить это для каждой продажи.
  • Проверка чарджбэка в Google Play остаётся единственным сценарием возврата на Android, где разработчик может предоставить доказательства, через orders.reviewrefund в течение 24 часов после PendingRefundReviewNotification.
  • По заказам в Google Play, оформленным после 3 августа 2026 года, разработчик при каждом проигранном чарджбэке платит цену покупки за вычетом сервисного сбора Play, а также комиссии банка за чарджбэк.

Каждое Android-приложение, которое продаёт через Google Play, должно выпустить следующее обновление с Play Billing Library 8 или новее. Срок версии 7 для новых приложений и обновлений истёк 31 августа 2026 года, а последние продления закончились 1 ноября 2026 года. Даты указаны в таблице в FAQ Google о прекращении поддержки, а напоминания приходят как предупреждения на странице «Статус соблюдения правил» в Play Console.

Для большинства команд это обновление зависимости и несколько переименованных методов. Для возвратов всё серьёзнее. Play Billing Library 8 удалила единственный клиентский вызов, который позволял приложению заглянуть в прошлые покупки. Теперь, если вы хотите знать, что пользователь купил, израсходовал или за что получил возврат, это должен помнить ваш сервер.

Что на самом деле блокирует срок Play Billing Library 8

Google даёт каждой версии библиотеки два года жизни. Прекращение поддержки останавливает только новые приложения и обновления. В FAQ Google сказано, что существующие приложения продолжают работать, а APK без поддержки обновлять не нужно. Так что для приложения, которое вы больше не трогаете, сегодня ничего не ломается. Ломается в тот день, когда вы захотите выпустить исправление, новую цену или новый пейволл.

Версия библиотекиСрок для новых приложений и обновленийСрок продления
631 августа 2025 г.1 ноября 2025 г.
731 августа 2026 г.1 ноября 2026 г.
831 августа 2027 г.1 ноября 2027 г.
931 августа 2028 г.1 ноября 2028 г.

Версия 8.0.0 вышла 30 июня 2025 года. Версия 9.0.0 вышла 19 мая 2026 года. Если вы мигрируете сейчас, переход сразу на 9 даёт на год больше, чем остановка на 8.

Почему Play Billing Library 8 важна для возвратов

Главное удаление касается queryPurchaseHistory(). Метод объявили устаревшим в версии 7 и удалили в версии 8.0.0. Заметки Google о миграции делят его прежнюю работу на три части, и только одна из них остаётся на устройстве.

Для чего вы использовали queryPurchaseHistory()Что Google советует теперьГде это работает
Активные и ожидающие покупкиqueryPurchasesAsync()На устройстве
Израсходованные разовые покупкиВаши собственные записиВаш сервер
Возвращённые, отменённые или оспоренные через чарджбэк покупкиVoided Purchases APIВаш сервер
Полная история покупок пользователяВаши собственные записиВаш сервер

Можно ли ещё восстановить расходуемые покупки на Android?

Не на стороне клиента. queryPurchasesAsync() возвращает только активное, поэтому израсходованный пакет кредитов или потраченный набор кристаллов через него уже не вернётся. Если пользователь переустановит приложение и спросит, куда делись его монеты, ответ должен взяться из журнала, который вы вели в момент покупки. Приложения, которые полагались на историю покупок как на бесплатную резервную копию, её потеряли.

Как теперь узнавать о возвратах?

Через два серверных канала. Real-time developer notifications отправляют VoidedPurchaseNotification с токеном покупки, ID заказа, типом продукта и типом возврата: полный возврат или частичный возврат по количеству. Voided Purchases API позволяет запрашивать те же события за выбранный период, как страховку на случай, если вы что-то пропустили.

У pull-API жёсткие ограничения. Он показывает только аннулированные покупки за последние 30 дней. Каждое приложение получает 6000 запросов в день и 30 запросов за любые 30 секунд. А возврат, оформленный разработчиком без опции отзыва, туда вообще не попадает. Сервер, который лежит пять недель, теряет возвраты, которые уже никогда не сможет получить.

Инженер с планшетом в тихом проходе серверной, где теперь нужно записывать возвращённые и израсходованные покупки Google Play, после того как Play Billing Library 8 убрала историю покупок на стороне клиента

В каких возвратах у разработчика ещё есть право голоса

Перенос учёта возвратов на сервер не даёт вам больше контроля над возвратами. Почти каждый возврат в Google Play решается без вас: самостоятельные возвраты, возвраты через поддержку, отмены и автоматические возвраты за неподтверждённые покупки. Вы узнаёте о них постфактум, из уведомления об аннулированной покупке.

Исключение составляет проверка чарджбэка. Когда покупатель подаёт чарджбэк, по которому нужна ваша позиция, Google отправляет PendingRefundReviewNotification. По словам Google, ответить нужно в течение 24 часов рекомендацией по возврату и доказательствами использования, вызвав orders.reviewrefund. Эти доказательства берутся из тех же серверных записей, которые новая библиотека и так заставляет вас вести. У команды, которая ведёт журнал для восстановления покупок, уже есть всё нужное для ответа.

Во что медленная миграция обходится в деньгах

Прямой риск связан с правилом трёх дней. Google Play автоматически возвращает деньги за покупку и отзывает доступ, если ваше приложение не подтвердило её в течение трёх дней. Для ожидающих покупок отсчёт начинается, когда покупка переходит из PENDING в PURCHASED. Миграция, которая ломает логику подключения, новый слушатель queryProductDetailsAsync() или настройку ожидающих покупок, может остановить подтверждения, не останавливая продажи. Каждый заказ в этом промежутке возвращается полностью, а пользователь уже получил то, за что заплатил.

Вот где больно. Возвращённый пакет кредитов на изображения всё равно сжёг время GPU на каждую генерацию. Возвращённый AI-тариф всё равно сделал платные вызовы API. Возвращённый тариф хранилища всё равно занял диски, за которые вы платите. Возвращённые чаевые всё равно ушли в выплату автору. Возврат отдаёт выручку покупателю, а эти счета оставляет вам.

Чарджбэки тоже подорожали. В справочном центре Google сказано, что по заказам, оформленным после 3 августа 2026 года, разработчик покрывает цену покупки за вычетом сервисного сбора Play, а также комиссии банка за чарджбэк. Google теперь платит только свой сервисный сбор. Приложение, которое не может за 24 часа ответить на проверку чарджбэка реальными данными об использовании, каждый раз оплачивает весь этот счёт.

Чек-лист миграции, который защищает выручку

  • Поднимите зависимость до Play Billing Library 8 или 9 и удалите queryPurchaseHistory(), querySkuDetailsAsync() и enablePendingPurchases() без аргументов.
  • Обновите слушатель queryProductDetailsAsync(). Начиная с версии 8 он также возвращает продукты, которые не удалось получить, вместе с кодом статуса.
  • Включите enableAutoServiceReconnection(), чтобы обрыв соединения с биллингом не останавливал обработку покупок.
  • Вызывайте queryPurchasesAsync() в onResume(), чтобы покупки, завершённые при закрытом приложении, всё равно подтверждались в течение трёх дней.
  • Записывайте на сервере каждый токен покупки, ID заказа и каждое расходование, привязывая их к собственному ID аккаунта.
  • Подпишитесь на Real-time developer notifications и обрабатывайте и VoidedPurchaseNotification, и PendingRefundReviewNotification.
  • Запускайте ежедневную синхронизацию с Voided Purchases API как страховку, с большим запасом в пределах 30-дневного окна и дневной квоты в 6000 запросов.

RefundHalt принимает уведомления Google Play об аннулированных покупках и проверках чарджбэков, отвечает на каждую проверку через orders.reviewrefund в пределах 24-часового окна с вашими реальными данными об использовании и хранит историю возвратов, которую ваше приложение больше не может запросить у устройства.

Частые вопросы

Нужно ли мне теперь использовать Play Billing Library 8?
Да, для любого нового приложения или обновления, которое продаёт через биллинг Google Play. В таблице прекращения поддержки Google сроком для версии 7 указано 31 августа 2026 года, а продления закончились 1 ноября 2026 года. Можно использовать версию 8 или более новую версию 9.
Перестанет ли работать моё приложение, если оно всё ещё использует Play Billing Library 7?
Нет. По словам Google, существующие приложения продолжают работать, а APK без поддержки обновлять не нужно. Прекращение поддержки только не даёт опубликовать новое приложение или обновление на неподдерживаемой версии.
Что заменило queryPurchaseHistoryAsync в Play Billing Library 8?
На устройстве эту работу не делает ничего. Google советует использовать queryPurchasesAsync() для активных и ожидающих покупок, учитывать израсходованные покупки на своём сервере и применять Voided Purchases API для отменённых или возвращённых покупок.
На какой срок назад работает Google Play Voided Purchases API?
На 30 дней. По словам Google, API показывает только аннулированные покупки за последние 30 дней и ограничивает каждое приложение 6000 запросами в день и 30 запросами за любые 30 секунд.
Вернёт ли Google Play деньги за покупку, если моё приложение её не подтвердит?
Да. Если покупка не подтверждена в течение трёх дней, пользователь автоматически получает возврат, а Google Play отзывает покупку. Для ожидающих покупок три дня отсчитываются с момента смены статуса с PENDING на PURCHASED.

Источники и дополнительное чтение

RefundHalt

Автопилот возвратов для App Store и Google Play

Читайте дальше

Правила и политика8 мин чтения

Бразилия проверяет, какие игры всё ещё продают лутбоксы детям, а счёт в итоге приходит через возвраты за лутбоксы

Министерство юстиции Бразилии попросило орган по защите данных следить за шестью играми, которые продают лутбоксы без проверки возраста. Что требует закон, что уже требуют Apple и Google и как оценивать и обрабатывать возвраты за лутбоксы, если лутбокс уже открыт.

Руководство8 мин чтения

Случайные встроенные покупки: возвраты, которые не выиграть. Решение находится на экране покупки

Случайные встроенные покупки возвращаются в обоих магазинах как возвраты, и никакие данные об использовании не докажут, что нажатие было намеренным. Разбираем, как Apple и Google их помечают, во что они обходятся вам в вычислениях и выплатах, и какой дизайн экрана покупки останавливает их до того, как появится списание.

Следующий запрос на возврат уже в пути.

Настройте RefundHalt за то время, что уходит на чтение очередного письма в поддержку о возврате, который вы не успели оспорить.