Усі статті
Детальний розбір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 за час, потрібний, щоб прочитати черговий лист у підтримку про повернення, яке ви не встигли оскаржити.