Прочитайте код причини повернення коштів, який ваш сервер уже отримує, і він підкаже, чи виправляти застосунок, чи боротися з клієнтом

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

Що насправді таке код причини повернення

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

Google Play проставляє причину та джерело на кожному анулюванні

Voided Purchases API від Google Play повертає один запис на кожну скасовану покупку, і кожен запис несе два цілих числа, які мають значення. voidedReason каже, чому покупку анулювали. voidedSource каже, хто це запустив. Разом вони перетворюють голе повернення на речення: це замовлення анулювали через зворотний платіж, ініційований Google, або анулювали як передумав, ініційований користувачем. Ви читаєте їх, опитуючи API або підписавшись на сповіщення розробника в реальному часі, яке спрацьовує, коли надходить анулювання. У будь-якому разі ці два числа, це payload, який варто зберегти.

Apple дає вужчий сигнал, але чіткий

Apple не дає вам причину з дев'ятьма варіантами. На поверненій транзакції Apple встановлює revocationReason в одне з двох значень. 1 означає, що App Store повернув кошти за транзакцію через реальну чи уявну проблему всередині вашого застосунку. 0 означає, що повернення сталося з іншої причини, наприклад через випадкову покупку. Поле з'являється лише на транзакціях, які повернули або анулювали, поряд із revocationDate, усередині підписаної інформації про транзакцію в REFUND App Store Server Notification. Два значення, це небагато, але те, що має значення, 1, це Apple каже вам, що повернення стосувалося вашого продукту, а не сумнівів клієнта.

Дев'ять причин, які дає вам Google Play

voidedReason від Google, багатший із двох, і кожне значення варто знати з першого погляду, бо кожне вказує кудись інде. Ось повний набір, прямо з ресурсу VoidedPurchase, із тим, що кожен код насправді каже вам робити.

voidedSource каже вам, хто натиснув на курок

Поряд із причиною стоїть voidedSource, і він відповідає на інше питання: хто скасував це. 0 означає, що це зробив користувач, через самообслуговування або банк. 1 означає, що це зробив розробник, тобто ви чи ваш власний інструментарій, оформивши повернення. 2 означає, що це зробив Google, на власний розсуд, включно з автоматичним поверненням за непідтверджену покупку. Коли ви бачите сплеск анулювань, джерело, це перший зріз. Стіна з source 2, це Google, який діє з вашим обліковим записом, і це зазвичай сигнал, що вказує назад на вашу інтеграцію, а не на ваших клієнтів.

Розсортуйте кожне повернення на виправити, боротися чи прийняти

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

Виправити: повернення, які спричинив ваш продукт

Деякі коди, це звіти про помилки в одязі повернення. Дефект (3) і не отримано (2) у Google, і revocationReason 1 в Apple, усі кажуть те саме: клієнт заплатив, а ваш застосунок не доставив. Непідтверджена покупка (8), найгостріший із них, бо провина повністю у вашому коді білінгу. Це найдешевші повернення для усунення, бо ви усуваєте їх, виправляючи те, чим володієте, а не переконуючи когось. Зростання лічильника в цій купі, це дефект продукту з доларовою цифрою, прикріпленою до нього.

Боротися: повернення, над якими хтось працює

Шахрайство (5), дружнє шахрайство (6) і зворотний платіж (7), це спори. Чисте шахрайство (5), це не ваш клієнт і не дохід, який ви коли-небудь збиралися лишати. Дружнє шахрайство (6), де покупець отримав саме те, за що заплатив, а потім оскаржив це, це єдиний спір, який ваші докази ще можуть зрушити, а зворотний платіж (7), це де ці докази подають. Коли одне з цих надходить, ви відкликаєте доступ, якщо ще цього не зробили, і там, де відкрите вікно розгляду, ви відповідаєте на нього тим, що знаєте про обліковий запис.

Прийняти: повернення, які ніколи не були вашими, щоб їх зупинити

Передумав (1) і випадкова покупка (4), це власна зміна думки клієнта. revocationReason 0 від Apple теж тут. Жодна функція не підвела і жодного шахрайства не сталося. Ви можете пом'якшити купу випадкових покупок чіткішим підтвердженням покупки, але ви не можете оскаржити повернення через передумав, і час, витрачений на спроби, це час, відібраний у купи виправити, де насправді лежать гроші.

Пастка 30 днів, через яку коди причин легко втратити

На боці Google є жорстке обмеження, яке перетворює це зі звітної функції на дедлайн. Якщо ви не захоплюєте коди безперервно, ви їх втрачаєте.

Voided Purchases API дивиться назад лише на 30 днів

Google прямо каже, що API може показати лише скасовані покупки за останні 30 днів. Старіші анулювання не повертаються, хоч би який startTime ви передали, а саме значення startTime не можна встановити раніше, ніж 30 днів тому. Гірше для наївної інтеграції, вікно 30 днів вимірюється тим, коли системи Google бачать покупку як анульовану, а не коли покупку зробили чи навіть за voidedTimeMillis у записі. Тож код причини повернення, який ви не витягнете в цьому вікні, зникає, а щомісячне завдання експорту з будь-яким розривом мовчки відкине анулювання, які воно не встигло захопити.

Скільки коди причин коштують у грошах

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

Один код, це рахунок, який ви виписали самі собі

voidedReason 8, непідтверджена покупка, це найчистіший приклад повернення, яке ви спричинили. Google Play вимагає, щоб ваш застосунок підтвердив покупку протягом трьох днів після надання доступу, і якщо ви цього не робите, Google автоматично повертає кошти за замовлення й анулює товар. Кожне анулювання, позначене 8, це реальний продаж клієнту, який хотів продукт, повернутий назад, бо виклик для підтвердження покупки так і не спрацював. Втрачена сума, це повна ціна продажу плюс обчислення, виклики API і сховище, які ви вже витратили на доставку. Це не повернення, про яке ви торгуєтеся. Це помилка, яку ви закриваєте, і код, це те, як ви її знаходите.

Код зворотного платежу тепер несе комісію

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

Як Apple і Google співвідносяться

Два магазини відповідають на те саме питання з різною роздільністю, тож міжмагазинний звіт про повернення має нормалізувати їх, а не очікувати, що вони збігатимуться.

Магазини ніколи не дадуть вам той самий код за те саме повернення, і це нормально. Що має значення, це те, що обидва дають вам машиночитану причину, і обидва винагороджують команду, яка її читає. Один біт Apple каже вам, коли повернення, це провина вашого продукту. Дев'ять причин Google і його прапорець джерела кажуть вам, яка саме помилка продукту, який спір і який самозаподіяний розрив у білінгу ви розглядаєте. Жоден код не зупиняє повернення. Обидва кажуть вам, що робити, щоб наступне не сталося.

RefundHalt захоплює код причини на кожному поверненні тієї миті, коли воно надходить, в обох магазинах, і тримає його з комфортним запасом усередині 30-денного вікна Google, тож нічого не вислизає. Він сортує кожне анулювання на виправити, боротися чи прийняти, тож сплеск коду 3 дефект доходить до вас як сповіщення про продукт, а сплеск коду 8 непідтверджена доходить до вас як помилка інтеграції, а не як розмите падіння доходу. Він відповідає на CONSUMPTION_REQUEST від Apple протягом 12 годин і на розгляд зворотного платежу Google Play протягом 24, і відкликає доступ тієї миті, коли надходить повернення чи зворотний платіж. Ви не можете змінити код, який магазин ставить на повернення. Ви можете переконатися, що читаєте кожен, і дієте за тими, які насправді ваші, щоб їх виправити.