Сповіщення про анульовану покупку дозволяє вашому серверу Google Play відкликати доступ у ту саму мить, коли надходить повернення коштів

Повернення коштів у Google Play не мусить бути тим, що ви виявляєте пізніше у звіті. Google Play може надіслати вашому серверу сповіщення про анульовану покупку в мить, коли покупку анулюють, незалежно від того, чи оформив покупець самостійне повернення, чи його надав агент підтримки, чи банк примусово провів чарджбек, чи ви самі повернули кошти за замовлення з увімкненим прапорцем відкликання. Повідомлення крихітне, воно називає саме ту покупку і несе одну вказівку, поверніть доступ, бо гроші вже пішли.

Що насправді таке сповіщення про анульовану покупку

Сповіщення про анульовану покупку це один із типів Real-time Developer Notifications, або RTDN, від Google Play. RTDN це push-канал. Google публікує повідомлення в топік Cloud Pub/Sub, яким ви володієте, і ваш бекенд отримує його за мить після події, а не дізнається про неї під час наступного запланованого опитування. У цьому й весь сенс сповіщення про анульовану покупку порівняно зі старим шляхом опитування: ви дізнаєтеся про повернення, коли воно відбувається, а не за кілька годин.

Шлях опитування досі існує і досі має значення. Voided Purchases API дозволяє вашому серверу за власним графіком запитувати список покупок, анульованих у певному діапазоні часу. Ці два підходи доповнюють один одного. Сповіщення повідомляє вас у мить, коли одна покупка змінює статус; API дозволяє звіряти дані масово та заповнювати все, що пропущене повідомлення залишило б поза увагою.

Воно передається всередині Real-time Developer Notification

Сповіщення про анульовану покупку ніколи не надходить саме собою. Воно міститься всередині обгортки DeveloperNotification, і ця обгортка доставляється як єдиний рядок у кодуванні base64 у полі data повідомлення Pub/Sub. Ваш обробник декодує цей рядок у JSON, перш ніж зможе щось прочитати. Обгортка завжди називає застосунок і час події та містить рівно один об'єкт сповіщення з п'яти, які визначає Google. Вони взаємовиключні, тож повідомлення, що несе voidedPurchaseNotification, не нестиме також події підписки чи разової покупки.

Чотири поля, які воно несе

Зніміть обгортку, і саме сповіщення про анульовану покупку це чотири поля. Це навмисно скупо. Позиція Google така: якщо все, що вам потрібно, це знайти правильну покупку та скоригувати доступ, цих чотирьох достатньо, і вам не доведеться звертатися до жодного API, щоб діяти.

productType повідомляє, що було анульовано

productType це невелике ціле число, і воно вирішує, який із ваших шляхів відкликання обрати. Анулювання підписки має згорнути тривалий доступ; анулювання разової покупки просто прибирає один окремий доступ.

refundType повідомляє, скільки повернулося

refundType відрізняє чисте повне повернення від часткового. Частковий випадок вузький. Він з'являється лише тоді, коли для разової покупки з кількома одиницями повернули частину, але не всю кількість.

Спершу увімкніть його, інакше воно ніколи не надійде

Сповіщення про анульовані покупки не надходять за замовчуванням. Ви один раз вмикаєте RTDN у Play Console і спрямовуєте його на топік Pub/Sub, який ви контролюєте. Перемикач розташований у розділі Monetize, далі Monetization setup, у секції Real-time developer notifications вгорі сторінки. Позначте Enable real-time notifications, потім вставте повну назву топіка у форматі projects/{project_id}/topics/{topic_name} і скористайтеся Send Test Message, щоб переконатися, що канал працює, перш ніж йому довіряти.

Перемикач вмісту це місце, де люди пропускають анульовані покупки. Обидва варіанти їх включають, тож ви не можете випадково відмовитися від повернень, зберігши підписки.

• Отримувати сповіщення про підписки та всі анульовані покупки. Ви отримуєте події підписок і кожну анульовану покупку, але не події купівлі разових продуктів.
• Отримувати всі сповіщення про підписки та разові продукти. Ви отримуєте зазначене вище плюс події разових продуктів, як-от ONE_TIME_PRODUCT_PURCHASED та ONE_TIME_PRODUCT_CANCELED.

Чого це коштує вам, у грошах

Анулювання це збиток, який уже зафіксовано на момент, коли сповіщення сягає вас. Ціна продажу зникла, як і все, що ви витратили на обслуговування цього клієнта. Якщо він генерував зображення, робив виклики до ваших моделей, споживав сховище чи спричинив виплату третій стороні, ці витрати були оплачені реальними грошима і не повертаються разом із поверненням. Сповіщення не може відновити нічого з цього. Що воно може зробити, це зупинити кровотечу відтепер, і саме в цьому вся причина діяти швидко.

Кровотеча найгірша на підписках і найгірша на чарджбеках. Підписка, яку ви не відкликали, продовжує коштувати вам на обслуговування, місяць за місяцем, для клієнта, який більше не платить. А чарджбек це найдорожчий вид анулювання. Починаючи з August 3, 2026, документація Google зазначає, що чарджбек перекладає на розробника ціну покупки плюс банківську комісію. Сповіщення про анульовану покупку часто є першим місцем, де ваші власні системи чують, що чарджбек завершився, тож обробник, який відкликає доступ на місці, це те, що не дає втраченому продажу перетворитися на втрачений продаж плюс тижні безкоштовного обслуговування.

Як обробити сповіщення про анульовану покупку, крок за кроком

Перевірте повідомлення та усуньте дублікати

• Підтвердьте, що повідомлення Pub/Sub надійшло від Google і спрямоване на топік, який ви налаштували, потім декодуйте поле data у base64, щоб отримати JSON DeveloperNotification.
• Використовуйте messageId з Pub/Sub, щоб відкидати дублікати. Google попереджає, що те саме сповіщення може бути доставлене більш ніж один раз, тож сприймайте повтор як норму і зробіть свій обробник ідемпотентним.
• Підтверджуйте повідомлення лише після того, як безпечно його зафіксували, щоб збій посеред роботи обробника не втратив подію.

Знайдіть покупку

• Зіставте purchaseToken із покупкою, яку ви зберегли, коли вперше надали доступ. Використовуйте orderId як запасний варіант для пошуку підтримкою та ручної звірки.
• Прочитайте productType, щоб обрати шлях відкликання для підписки чи разової покупки, і прочитайте refundType, щоб вирішити між повним відкликанням і частковим.

Відкличте та зафіксуйте

• Приберіть доступ. Для повного повернення відріжте доступ до товару. Для часткового повернення за кількістю зменшіть надану кількість на суму повернення, а решту залиште недоторканою.
• Запишіть, що ви зробили і коли, за ключами purchaseToken та orderId. Саме цей запис дає вам змогу пізніше відповісти на звернення до підтримки і дозволяє Voided Purchases API чисто звірятися з вашим власним станом.

Де воно стоїть серед інших сигналів про повернення

Сповіщення про анульовану покупку це повідомлення, а не перемовини. Воно повідомляє вам про наслідок, який уже вирішено. Варто розглянути його поряд із сигналами, які з ним легко сплутати, адже лише деякі з них взагалі запитують вашу версію подій.

Головна думка проста. В обох магазинах є рівно два процеси повернення, де розробник має право голосу, це CONSUMPTION_REQUEST від Apple та розгляд чарджбеку в Google Play. Сповіщення про анульовану покупку не є жодним із них. На момент, коли воно сягає вас, рішення вже позаду, і єдине, що лишається у ваших руках, це те, наскільки швидко ви відкликаєте доступ.