Повернення коштів у Family Sharing скасовує один платіж, але може лишити ще п'ятьох людей, які й далі користуються вашим застосунком, і тільки ваш сервер здатен їх відключити

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

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

Що роздає Family Sharing і скільком людям

Увімкніть Family Sharing для продукту, і ви зміните те, хто є вашим платним клієнтом. Родинна група в Apple може мати до шести людей, одного організатора й до п'яти учасників. Коли будь-хто в групі купує продукт, доступний для спільного користування в родині, доступ до нього отримують усі в групі. Вони не платять. Вони не з'являються у вашому доході. Вони просто виникають у вашому застосунку з чинним правом доступу, бо Apple видає кожному з них транзакцію, що вказує на ту саму покупку.

Лише два типи продуктів доступні для спільного користування, і споживані не з їх числа

Family Sharing охоплює рівно два види вбудованих покупок: неспоживані й автопродовжувані підписки. Споживані, продукти на кшталт монет і кредитів, ніколи не діляться, тому член родини ніколи не запускає CONSUMPTION_REQUEST і не з'являється у вашій звітності про споживання. Якщо ваш застосунок продає лише споживані продукти, повернення коштів у Family Sharing не ваша проблема. Якщо ви продаєте довічне розблокування чи повторюваний план, це ваша проблема.

Поле, що відрізняє покупця від вигодоотримувача

Кожна транзакція, яку видає Apple, несе inAppOwnershipType. Воно має два значення. PURCHASED означає, що цей обліковий запис заплатив за продукт і може ним керувати, зокрема скасувати чи запросити повернення коштів. FAMILY_SHARED означає, що цей обліковий запис це член родини, який має доступ через чиюсь покупку. Обидва значення дають людині право користуватися вашим продуктом. Заплатив лише один із них. Це поле є на транзакції StoreKit, у чеку й у App Store Server API, тож ви можете читати його всюди, де вже перевіряєте права доступу.

Як повернення коштів у Family Sharing доходить до вашого сервера

Повернення коштів за спільну покупку починається так само, як будь-яке повернення в Apple. Покупець, єдиний, хто може, просить Apple повернути гроші. Apple вирішує. Якщо Apple схвалює, покупку покупця скасовано, і Apple надсилає вашому серверу App Store Server Notification типу REVOKE. І V1, і V2 сповіщення несуть його. REVOKE це ваш єдиний сигнал, що право доступу за ним, і кожна його копія зі спільним доступом у родині, тепер недійсне.

Не відкликайте одну транзакцію, перечитайте всю історію

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

Одна деталь, що відрізняє повернення коштів від розпаду родини

Ось пастка, що коштує командам цілого дня налагодження. REVOKE може означати дві дуже різні речі для транзакції FAMILY_SHARED, і спосіб, у який ви їх розрізняєте, це поле, якого іноді просто немає. Коли покупець отримує повернення коштів, транзакція FAMILY_SHARED приходить із revocationDate. Коли член родини просто виходить із групи, той самий тип REVOKE приходить узагалі без revocationDate. Комерційні інженери Apple прямо сказали про це на форумах для розробників. У будь-якому разі ви прибираєте доступ, але лише той, що з датою, є поверненням коштів, і лише повернення коштів це те, що також скасувало платіж.

Скільки насправді коштує вам спільне повернення коштів

Пройдіть по грошах, бо саме тут Family Sharing тихо змінює арифметику. Звичайне повернення скасовує один продаж. Apple повертає ціну покупцю й віддає свою комісію, тож бік магазину виходить майже в нуль. Ніколи не повертається те, що ви вже витратили на доставлення продукту. З Family Sharing ви витратили це не раз. Ви витратили це на аж шість людей. Покупець і до п'яти членів родини кожен запускав ваші обчислення, викликав ваші API, заповнював ваше сховище й витягував будь-які виплати, які ви фінансуєте, і все це на підставі одного платежу.

Тепер покупець повертає кошти. Один платіж скасовується. Доступ кожного члена родини має завершитися тієї самої миті, бо те, що виправдовувало їх обслуговування, одна оплачена покупка, зникло. Якщо ваш сервер відкликає лише транзакцію PURCHASED і лишає транзакції FAMILY_SHARED живими, до п'яти людей далі користуються вашими платними функціями безкоштовно, а ви й далі платите за їх обслуговування, і в системі не лишається нічого, за що виставити рахунок. Це не похибка округлення. Це вп'ятеро більше за вартість доставлення продажу, який ви щойно повернули.

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

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

Як зробити це правильно і протестувати, перш ніж це зробить справжнє повернення

Тут немає нічого екзотичного, що треба будувати. Уся робота полягає в тому, щоб прив'язати доступ до права, а не до покупця, і перебудовувати цей доступ на кожен REVOKE.

• Зберігайте доступ проти транзакції та її inAppOwnershipType, а не проти єдиного облікового запису покупця, щоб транзакція FAMILY_SHARED надавала доступ сама по собі і могла бути відкликана сама по собі.
• На будь-яке сповіщення REVOKE перечитуйте повну історію транзакцій клієнта й переобчислюйте права доступу, замість того щоб вимикати єдину названу транзакцію.
• Сприймайте транзакцію FAMILY_SHARED із revocationDate як повернення коштів і завершуйте доступ цього учасника. Сприймайте ту, що без revocationDate, як вихід із родини й завершуйте його теж.
• Не поспішайте вводити зовсім нову спільну покупку в обслуговування. Apple тримає її приблизно годину, щоб покупець міг відступити, тож зважайте на транзакцію, яку Apple насправді видає, а не надавайте доступ за дотиком купівлі.
• Відрепетируйте це. Інструментарій Apple Testing Family Sharing дає змогу змоделювати спільну транзакцію, а повернення коштів у пісочниці запускає той самий REVOKE, який отримає ваш продакшн-сервер.

Зробіть так, і повернення коштів у Family Sharing стане непомітною подією. Покупець отримує свої гроші, уся група втрачає доступ у тому самому такті, а ви припиняєте платити за обслуговування людей, які ніколи вам не платили.