Play Billing Library 8 тепер обов'язкова для кожного оновлення в Google Play і переносить облік повернень на ваш сервер
Продовження, яке Google давав для Play Billing Library 7, закінчилося 1 листопада 2026 року, тож новим застосункам і оновленням потрібна версія 8 або новіша. У версії 8 видалено queryPurchaseHistory(), і тепер повернені та використані покупки треба обліковувати на сервері. Розбираємо, що змінилося і скільки коштує повільна міграція.

Головне
- У таблиці припинення підтримки 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 без підтримки оновлювати не потрібно. Тож для застосунку, якого ви більше не торкаєтеся, сьогодні нічого не ламається. Ламається того дня, коли ви захочете випустити виправлення, нову ціну чи новий пейвол.
| Версія бібліотеки | Строк для нових застосунків і оновлень | Строк продовження |
|---|---|---|
| 6 | 31 серпня 2025 р. | 1 листопада 2025 р. |
| 7 | 31 серпня 2026 р. | 1 листопада 2026 р. |
| 8 | 31 серпня 2027 р. | 1 листопада 2027 р. |
| 9 | 31 серпня 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 вирішується без вас: самостійні повернення, повернення через підтримку, скасування й автоматичні повернення за непідтверджені покупки. Ви дізнаєтеся про них постфактум, зі сповіщення про анульовану покупку.
Виняток становить перевірка чарджбеку. Коли покупець подає чарджбек, за яким потрібна ваша позиція, 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.
Джерела та додаткове читання
- 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
Автопілот повернень для App Store і Google Play
Читайте далі
Бразилія перевіряє, які ігри досі продають дітям лутбокси, і рахунок приходить через повернення коштів за лутбокси
Міністерство юстиції Бразилії попросило орган із захисту даних стежити за шістьма іграми, які продають лутбокси без перевірки віку. Пояснюємо, що вимагає закон, чого вже вимагають Apple і Google, і як оцінювати та обробляти повернення коштів за лутбокси, коли бокс уже відкрито.
Випадкові покупки в застосунку є відшкодуваннями, які неможливо виграти, тож рішення має бути на екрані покупки
Випадкові покупки в застосунку повертаються як відшкодування в обох магазинах, і жодні дані про використання не доводять, що дотик був навмисним. Розповідаємо, як Apple і Google їх позначають, скільки кожна з них коштує вам в обчисленнях і виплатах, і який дизайн екрана покупки зупиняє їх ще до появи списання.