Ви можете самостійно повернути кошти за замовлення Google Play, і зробивши це до зворотного платежу, ви заощаджуєте банківську комісію
Ви можете повернути кошти за будь-яке замовлення Google Play, молодше за three years, одним викликом API, з відкликанням доступу або без нього. Зробивши це самостійно, перш ніж суперечка перетвориться на зворотний платіж, ви заощаджуєте банківську комісію, яка з August 3, 2026 лягає на розробників. Ось як працює orders.refund.

Головне
- Кінцева точка `orders.refund` у Google Play Developer API дозволяє розробнику безпосередньо повернути кошти за будь-яке разове замовлення чи замовлення підписки, без перевірки, без потреби вказувати причину та без запиту клієнта.
- Повернення коштів і відкликання це окремі дії. `orders.refund` приймає необовʼязковий прапорець `revoke`. Залиште його вимкненим, і покупець збереже доступ, установіть його на true, і Google негайно припинить доступ до товару.
- Замовлення, старші за three years, не можна повернути через Google Play Developer API. Щойно це вікно закривається, замовлення назавжди стає недосяжним.
- `orders.refund` виконує лише повне повернення коштів. Часткове, пропорційне повернення за підписку вимагає новішої кінцевої точки `purchases.subscriptionsv2.revoke` з контекстом `proratedRefund`.
- Повернення коштів за замовлення підписки з `revoke`, установленим на true, запускає сповіщення `SUBSCRIPTION_REVOKED` Real-time Developer Notification, тож ваш бекенд дізнається про відкликання так само, як про будь-яку іншу подію підписки.
- З August 3, 2026 Google стягує з розробника ціну покупки плюс банківські комісії зворотного платежу. Повернення, яке ви оформлюєте самі, повертає лише ціну покупки, тож раннє повернення за хитке замовлення може бути дешевшим, ніж дати йому перетворитися на зворотний платіж.
- Повернення за ініціативою розробника це єдиний потік повернень Google Play, який ви повністю контролюєте. 48-hour самообслуговуване повернення, повернення через підтримку та анульовані покупки вирішуються без вас.
Вам не потрібно чекати, поки клієнт відкриє суперечку. Якщо ви хочете повернути гроші, ви можете самостійно повернути кошти за замовлення Google Play, безпосередньо, одним викликом API або двома кліками в Play Console. Google не запитає вас чому і не піддасть сумніву ваше рішення. Це єдиний потік повернень, у якому кнопка у ваших руках, і скористатися нею рано, перш ніж суперечка затвердіє в банківський зворотний платіж, часто є найдешевшим виходом.
Єдиний потік повернень, який ви справді контролюєте
Більшість повернень у Google Play трапляються з вами, а не через вас. Покупець, який звертається до Google протягом 48 hours, отримує автоматичне самообслуговуване повернення без участі розробника. Агент підтримки може надати таке, що є остаточним у момент оформлення. Банківський зворотний платіж вирішується між власником картки та його банком. У всіх цих випадках ви глядач, який дізнається постфактум.
Повернення розробника це виняток. Тут саме ви вирішуєте повернути гроші, за власним графіком, з власних причин. Це інструмент доброї волі, інструмент обслуговування клієнтів і, тихо, інструмент контролю витрат. Точне знання того, як він поводиться, перетворює його з кнопки паніки на свідомий вибір.
Що робить orders.refund, за один виклик
Метод orders.refund у Google Play Developer API повертає кошти за одне замовлення, незалежно від того, чи було це разове внутрішнє придбання, чи платіж за підписку. Ви надсилаєте порожній POST на шлях повернення замовлення, автентифікований вашим службовим обліковим записом, і успішний виклик повертає порожнє тіло. Це весь механізм.
Прапорець revoke вирішує, чи збережуть вони доступ
Єдиний вибір, який дає вам виклик, це прапорець запиту revoke. Довідник Google прямо каже про те, що він робить: якщо встановлено на true, доступ до підписки або внутрішнього товару буде негайно припинено. Пропустіть його, і гроші повертаються, тоді як клієнт зберігає те, що придбав. Це одне логічне значення і є різницею між дружнім поверненням і чистим скасуванням.
| Частина виклику | Значення |
|---|---|
| Метод і шлях | POST /androidpublisher/v3/applications/{packageName}/orders/{orderId}:refund |
packageName | Ідентифікатор вашого застосунку, наприклад com.acme.app |
orderId | Ідентифікатор замовлення, показаний покупцю під час покупки |
revoke | Необовʼязковий прапорець запиту. true негайно припиняє доступ, пропустіть його, щоб повернути кошти й залишити доступ недоторканим |
| Тіло запиту | Порожнє |
| Область OAuth | https://www.googleapis.com/auth/androidpublisher |
За замовчуванням повне повернення, пропорційне лише для підписок
orders.refund повертає всю вартість замовлення. У нього немає поля для часткової суми. Якщо вам потрібно повернути частину підписки, зверніться до новішої кінцевої точки purchases.subscriptionsv2.revoke, яка приймає контекст відкликання й може оформити або повне, або пропорційне повернення на основі часу, що залишився в періоді. Старіший purchases.subscriptions.revoke робив лише повні повернення, що є головною причиною існування методу v2. Для разових замовлень часткові повернення доступні через вебсайт Play Console для покупок, здійснених після March 2018, і ніколи для платних застосунків.

Трирічна стіна та інші обмеження
Жорстка межа це вік. Google прямо заявляє, що замовлення, старші за three years, не можна повернути. Немає ні оскарження, ні винятку, щойно замовлення перетинає цю лінію, тож повернення це рішення з датою закінчення терміну. Кілька інших обмежень формують те, що виклик може й чого не може зробити.
| Обмеження | Що це означає |
|---|---|
| Обмеження за віком у три роки | Замовлення, старші за three years, не можна повернути через API |
| Лише повна сума | orders.refund повертає всю вартість замовлення, ніколи часткову суму |
| Часткові повернення | Доступні для підписок через purchases.subscriptionsv2.revoke або через Play Console для разових замовлень після March 2018, ніколи для платних застосунків |
| Незворотне | Щойно ви оформили повернення, його не можна скасувати |
Що це заощаджує вам у грошах
Кожне повернення вже є збитком ще до того, як ви торкнетеся кнопки, бо гроші, витрачені на обслуговування цієї покупки, не повертаються разом із нею. Якщо покупець генерував зображення, робив виклики API до ваших моделей, споживав сховище або запускав виплату третій стороні, ці витрати вже здійснені й залишаються здійсненими. Повернення лише вирішує, хто понесе ціну продажу понад це.
Причина самому вдатися до повернення це те, що станеться, якщо ви цього не зробите. Документація Google однозначна: з August 3, 2026, коли клієнт оскаржує списання у своєму банку, Google передає розробнику ціну покупки та комісію банку за зворотний платіж. Повернення, яке ви оформлюєте через orders.refund, повертає лише ціну покупки. Тож для замовлення, яке ви й так очікуєте втратити, самостійно оформлене повернення дешевше за зворотний платіж рівно на банківську комісію, і воно закриває справу, перш ніж вона зможе загостритися.
Де самостійне повернення стоїть серед інших потоків повернень
Корисно побачити повернення розробника поруч з усім іншим, що може витягнути гроші з вашого рахунку. Лише два з цих потоків узагалі запитують ваш внесок, і лише один із них дозволяє вам самостійно розпочати повернення.
| Потік повернення | Хто вирішує | Ваш контроль |
|---|---|---|
Повернення розробника (orders.refund) | Ви | Повний. Ви обираєте чи і коли |
| 48-hour самообслуговуване повернення | Немає. Google повертає автоматично | |
| Повернення агентом підтримки | Google або Apple support | Немає. Остаточне після надання |
Перевірка зворотного платежу (orders.reviewrefund) | Google, на основі ваших доказів | Лише 24-hour вікно для внеску |
| Voided Purchases API | Ніхто, це лише для читання | Немає. Ви лише читаєте те, що вже сталося |
Як повернути кошти за замовлення Google Play, від початку до кінця
З Play Console
- Відкрийте Play Console і виберіть Керування замовленнями в лівому меню.
- Знайдіть замовлення за його ідентифікатором замовлення або повною адресою електронної пошти покупця.
- Під ціною виберіть Повернути кошти й виберіть причину повернення. Використовуйте вебсайт, а не мобільний застосунок, якщо вам потрібне часткове повернення.
З API
- Автентифікуйте службовий обліковий запис, який має область
androidpublisherта фінансові дозволи в Play Console. - Надішліть порожній POST на шлях повернення замовлення, додаючи
revoke=true, лише якщо ви також хочете відрізати доступ. - Обробіть порожню відповідь про успіх, і якщо ви відкликали підписку, очікуйте сповіщення
SUBSCRIPTION_REVOKED, що дійде до вашого бекенду.
Повернення розробника це малий, гострий інструмент. Він дає вам чистий спосіб віддячити клієнту й дешевший вихід, ніж зворотний платіж за замовлення, яке ви й так втратили б. Єдине правило використовувати його свідомо, з прапорцем revoke, установленим так, як ви справді маєте на увазі.
Поширені запитання
- Чи можу я повернути кошти за замовлення Google Play, не скасовуючи доступ клієнта?
- Так. Викличте `orders.refund` і залиште прапорець `revoke` вимкненим. Покупець отримує свої гроші назад і зберігає доступ до товару. Установлюйте `revoke` на true лише тоді, коли ви також хочете негайно припинити доступ до покупки.
- Наскільки давнє замовлення я можу повернути в Google Play?
- До three years від дати покупки. Google Play Developer API зазначає, що замовлення, старші за three years, не можна повернути, і немає винятку, щойно це вікно закривається.
- Чи підтримує orders.refund часткові повернення?
- Ні. `orders.refund` оформлює лише повну суму замовлення. Для часткового або пропорційного повернення за підписку використовуйте `purchases.subscriptionsv2.revoke` з контекстом `proratedRefund` або оформіть часткове повернення через Play Console для придатних разових замовлень.
- Чи дізнається мій бекенд, коли я відкликаю підписку з поверненням?
- Так. Повернення коштів за замовлення підписки з `revoke`, установленим на true, запускає сповіщення `SUBSCRIPTION_REVOKED` Real-time Developer Notification, тож ваш сервер може оновити право доступу так само, як він обробляє будь-яку іншу подію підписки.
- Чи краще повернути кошти за замовлення самому, ніж дати йому стати зворотним платежем?
- Часто, у суто грошовому вимірі. З August 3, 2026 зворотний платіж коштує розробнику ціни покупки плюс банківської комісії, тоді як повернення, яке ви оформлюєте, повертає лише ціну покупки. Якщо замовлення явно прямує до суперечки, раннє повернення дозволяє уникнути додаткової банківської комісії.
Джерела та додаткове читання
- Google Play Developer API: Method orders.refund
- Android Developers: Manage subscriptions and one-time purchases
- Play Console Help: Manage your app's orders and issue refunds
- Google Play Developer API: Method purchases.subscriptionsv2.revoke
- Google Play Console Help: refund protection and chargeback cost responsibility
- Google Play Help: Learn about Google Play refund policies
RefundHalt
Автопілот повернень для App Store і Google Play
Читайте далі
Apple Send Consumption Information тепер запитує п'ять полів, а не дванадцять, і ось кожне з них
Коли клієнт просить Apple про повернення коштів, корисне навантаження Send Consumption Information це ваша відповідь. Apple скоротило його з дванадцяти полів до п'яти, три обов'язкові та два необов'язкові. Ось кожне поле, значення, які приймає кожне з них, і 12-годинне вікно, протягом якого ви його надсилаєте.
Є один endpoint, який повертає всю App Store refund history клієнта, і ось що він віддає у відповідь
Endpoint Get Refund History від Apple повертає повну App Store refund history клієнта як підписані транзакції. Ось кожне поле, як токен revision розбиває на сторінки, чому він працює на клієнта, а не на застосунок, і скільки коштує вам пропущене відшкодування.