В этой статье рассказывается, как обрабатывать события жизненного цикла подписки, например продление и окончание срока действия. Также вы узнаете о дополнительных функциях, например о том, как предлагать промоакции и разрешать пользователям самостоятельно управлять подписками.
Если вы ещё не настроили подписки для своего приложения, прочитайте статью Как создавать и настраивать контент.
Обзор подписок
Подписка – это повторяющаяся транзакция, которая предоставляет пользователям определенные права. Права доступа представляют собой набор преимуществ, которые пользователи могут получить в течение определенного периода времени. Например, подписка может давать пользователю премиум-доступ.
С помощью основных планов и специальных предложений можно создать несколько конфигураций для одного и того же контента по подписке. Например, вы можете создать начальное предложение для пользователей, которые никогда не оформляли подписку в вашем приложении, или предложение о переходе на более дорогой план для тех, у кого уже есть подписка.
Подробную информацию о подписках, основных планах и специальных предложениях можно найти в Справочном центре Play Console.
Библиотека Play Платежей поддерживает следующие типы подписок:
Подписка. В этом случае один товар соответствует одному праву. Например, подписка на стриминговый сервис музыки.
Подписка с дополнениями. В этом случае одна покупка может включать несколько отдельных прав доступа. Например, подписка на стриминговый сервис музыки и подписка на видео. Подробнее о подписках с дополнениями…
Интеграция планов с предоплатой
Тарифные планы с предоплатой не продлеваются автоматически. Чтобы продлить подписку без перерыва, пользователю нужно пополнить баланс для того же тарифного плана.
Чтобы пополнить баланс, запустите сценарий оплаты, как при первоначальной покупке. Указывать, что покупка является пополнением баланса, не нужно.
При пополнении баланса предоплаченного плана всегда используется режим замены CHARGE_FULL_PRICE, и вам не нужно задавать его явным образом. С пользователя сразу списывается плата за полный расчетный период, а доступ к контенту продлевается на срок, указанный в дополнении.
После пополнения баланса следующие поля в объекте результата Purchase обновляются, чтобы отразить последнюю покупку:
- Идентификатор заказа
- Время покупки
- Подпись
- Токен покупки
- Подтвержденные
Следующие поля Purchase всегда содержат те же данные, что и исходная покупка:
- Название пакета
- Статус покупки
- Товары
- Автоматическое продление
Подтверждение покупки с предоплатой
Как и в случае с автоматически продлеваемыми подписками, после покупки плана с предоплатой вы должны подтвердить ее. Подтверждать нужно как первоначальную покупку, так и все пополнения. Подробнее об обработке покупок…
Поскольку предоплаченные планы могут быть краткосрочными, важно подтверждать покупку как можно скорее.
Тарифные планы с предоплатой на неделю или дольше должны быть подтверждены в течение трех дней.
Тарифные планы по предоплате, действующие менее недели, должны быть подтверждены в течение половины срока действия. Например, у разработчиков есть 1,5 дня, чтобы подтвердить трехдневный предоплаченный план.
Интеграция подписок с рассрочкой
Подписка с рассрочкой – это тип подписки, при котором пользователи оплачивают ее частями в течение определенного периода времени, а не вносят всю стоимость подписки сразу.
Дополнительные сведения о подписках с рассрочкой:
- Доступность по странам. Подписки с рассрочкой доступны только в Бразилии, Испании, Италии и Франции. Актуальный список стран можно посмотреть в Play Console.
- Установка цены. При установке цены для подписки с рассрочкой в Play Console указывается сумма ежемесячного платежа. Вместе с минимальным сроком подписки она определяет общую стоимость подписки, которая показывается на экране покупки.
- Минимальный срок подписки. Общая продолжительность первоначальной подписки, в течение которой необходимо вносить ежемесячные платежи. Например, если минимальный срок подписки составляет 15 месяцев, пользователь должен будет совершить 15 ежемесячных платежей.
- Продление. В контексте подписок с рассрочкой платежа "продление" означает завершение минимального срока подписки (первоначального или последующего). После первоначальной регистрации первое продление происходит по завершении всего первоначального минимального срока подписки. Последующие продления происходят после завершения каждого последующего минимального срока подписки. Для подписок с оплатой частями доступны следующие типы продления: "автоматическое продление каждый месяц" и "автоматическое продление на тот же срок". Для тарифных планов с автоматическим ежемесячным продлением последующих обязательств нет, и они работают как ежемесячная подписка, где каждый ежемесячный платеж за подписку представляет собой продление.
- Расчетный период. В контексте подписок с рассрочкой это повторяющийся интервал, с которым вносятся отдельные платежи, как указано в основном плане.
- Изменение тарифного плана и изменение цены. При изменении цены и отмене подписки обязательства остаются в силе. Это значит, что если пользователь хочет отменить подписку или разработчик хочет изменить цену, изменение вступит в силу в конце минимального срока подписки. При изменении тарифного плана обязательство не является фиксированным. Это означает, что для изменения плана не нужно ждать окончания минимального срока подписки. Изменение вступает в силу немедленно или в следующую дату платежа в зависимости от заданного режима замены.
- Смена плана в рамках одной подписки. Нельзя перейти с основного плана с рассрочкой на основной план без рассрочки в рамках одной подписки.
Уведомления для разработчиков в режиме реального времени (RTDN).
SUBSCRIPTION_CANCELLATION_SCHEDULEDУведомление RTDN отправляется сразу после того, как пользователь отменяет подписку, если в течение минимального срока подписки остаются платежи. Отмена ожидает обработки и вступит в силу только в конце минимального срока подписки. Если пользователь не восстановит подписку, в конце минимального срока будут отправлены уведомленияSUBSCRIPTION_CANCELEDиSUBSCRIPTION_EXPIRED.Выплаты и получение дохода. Разработчик получает выплаты ежемесячно, после того как пользователь внес платеж. Действуют те же условия, что и для других подписок. При оформлении подписки предоплата не предусмотрена.
Пропущенные платежи. Если пользователь не вносит платеж за подписку в рассрочку, ни Google, ни разработчик не будут пытаться взыскать с него пропущенные или невыплаченные суммы. Однако Google может периодически пытаться списать средства в течение льготного периода или временной блокировки аккаунта в соответствии с обычной практикой повторных попыток списания. Google не несет ответственности перед Разработчиком за оставшиеся неоплаченные взносы.
Доступность библиотеки Play Платежей. Поле
installmentDetailsдоступно только в библиотеке Play Платежей версии 7 и более поздних. В PBL 5 и более поздних версиях подписка с рассрочкой возвращается с помощьюqueryProductDetails(), но не содержит подробной информации о рассрочке, например количества обязательных платежей.
Как использовать ссылки на контент, чтобы пользователи могли управлять подпиской
В настройках приложения должна быть ссылка, по которой пользователи могут управлять своими подписками. Ее можно оформить в стиле приложения.
Вы можете добавить в приложение ссылку на контент, ведущую в центр подписок Google Play, для подписок, срок действия которых не истек. Определить их можно с помощью поля subscriptionState ресурса подписки. Исходя из этого, есть несколько способов создать ссылку на контент, ведущую в центр подписок Google Play.
Ссылка на центр подписок
Чтобы направить пользователей на страницу со всеми их подписками, как показано на рисунках 1 и 2, используйте следующий URL:
https://play.google.com/store/account/subscriptions
Эта ссылка на контент может быть полезна, чтобы помочь пользователю восстановить отмененную подписку в центре подписок Google Play.
Ссылка на страницу управления подпиской (рекомендуется)
Чтобы создать прямую ссылку на страницу управления действующей подпиской, укажите название пакета и productId, связанные с приобретенной подпиской. Чтобы программно определить productId для существующей подписки, отправьте запрос к серверной части приложения или вызовите BillingClient.queryPurchasesAsync(), чтобы получить список подписок, связанных с определенным пользователем. Каждая подписка содержит соответствующий параметр productId в составе информации о статусе подписки.
Каждый объект SubscriptionPurchaseLineItem, связанный с покупкой подписки, содержит значение productId, связанное с подпиской, которую пользователь приобрел в этой позиции.
Чтобы направить пользователей на определенный экран управления подпиской, используйте следующий URL, заменив "your-sub-product-id" и "your-app-package" на productId и название пакета приложения соответственно:
https://play.google.com/store/account/subscriptions?sku=your-sub-product-id&package=your-app-package
После этого пользователь сможет управлять способами оплаты и получит доступ к таким функциям, как отмена, возобновление и приостановка подписки.
Как разрешить пользователям менять подписку
Вы можете предложить существующим подписчикам различные варианты изменения тарифного плана, чтобы он лучше соответствовал их потребностям:
- Если у вас есть несколько уровней подписки, например базовая и премиум, вы можете разрешить пользователям переключаться между ними, приобретая другой основной план или специальное предложение.
- Вы можете разрешить пользователям менять расчетный период, например переходить с ежемесячного плана на годовой.
- Вы также можете разрешить пользователям переключаться между планами с автоматическим продлением и предоплатой.
Чтобы стимулировать пользователей к таким изменениям, вы можете предлагать им скидки. Например, вы можете создать специальное предложение со скидкой 50 % на первый год при переходе с месячного тарифа на годовой план и ограничить его пользователями, у которых оформлен месячный тариф и которые ещё не приобрели это предложение. Подробнее о требованиях к специальным предложениям можно узнать в Справочном центре.
На рисунке 3 показан пример приложения с тремя разными планами:
В приложении можно показать экран, похожий на тот, что изображен на рисунке 3, и предложить пользователям варианты изменения подписки. В любом случае пользователям должно быть понятно, какая у них текущая подписка и какие есть варианты ее изменения.
Когда пользователь решает перейти на другой тарифный план или изменить подписку, вы указываете режим замены, который определяет, как применяется пропорциональная стоимость текущего оплаченного расчетного периода и когда происходит изменение доступа.
Режимы замены
В таблице ниже перечислены доступные режимы замены, примеры их использования и количество платежей, которые считаются оплаченными.
Режим замены |
Описание |
Примеры использования |
Обязательные платежи, зарегистрированные как оплаченные (для замены подписки с рассрочкой) |
|
Обновление или понижение версии подписки происходит немедленно. Оставшееся время корректируется с учетом разницы в цене и переносится в новую подписку. При этом дата выставления счетов сдвигается. Этот вариант используется по умолчанию. |
Переход на более дорогой уровень без немедленной дополнительной оплаты. |
0 |
|
Подписка обновляется немедленно, а платежный цикл остается прежним. Разница в цене за оставшийся период списывается со счета пользователя. Примечание. Этот вариант доступен только при переходе на более дорогую подписку, когда цена за единицу времени увеличивается. |
Перейти на более дорогой уровень без изменения даты оплаты. |
1 |
|
Уровень подписки повышается или понижается немедленно, и с пользователя сразу же взимается полная стоимость нового права. Оставшаяся стоимость предыдущей подписки либо переносится на то же право, либо пропорционально распределяется по времени при переходе на другое право. Примечание. Если для новой подписки предусмотрен бесплатный пробный период или специальное предложение для новых пользователей, то при переходе на нее с пользователя списывается 0 долларов США или стоимость специального предложения. |
Переход с более короткого на более длинный расчетный период. |
1 (Примечание: 0, если у новой подписки есть бесплатный пробный период). |
|
Обновление подписки происходит сразу, а новая цена начинает действовать со следующего платежного цикла. Платежный цикл остается прежним. |
Перейти на более высокий уровень подписки, сохранив оставшийся бесплатный период. |
0 |
|
Объект подписки обновляется или понижается только при продлении подписки, но новая покупка оформляется немедленно со следующими двумя объектами:
Примечание. Для подписок с рассрочкой тарифный план меняется в начале следующей даты платежа. |
Перейти на более дешевый уровень. |
1 |
|
График платежей за подписку остается прежним. |
Добавление или удаление элемента подписки из подписки с дополнениями, когда определенный элемент должен оставаться неизменным. |
Н/Д |
Чтобы узнать больше о том, как использовать предложения о повышении или понижении уровня подписки для допродаж и возврата пользователей, ознакомьтесь с руководством по специальным предложениям и промоакциям.
Как настроить режим замены для покупки
Вы можете использовать разные режимы замены для разных типов переходов между подписками в зависимости от ваших предпочтений и бизнес-логики. В этом разделе объясняется, как установить режим замены для изменения подписки и какие ограничения применяются.
Как возобновить подписку или сменить тарифный план в рамках одной подписки
Вы можете указать режим замены по умолчанию в Google Play Console. Этот параметр позволяет выбрать дату списания средств для пользователей, сменивших основной тарифный план, активировавших специальное предложение для текущей подписки или возобновивших ее после отмены. Доступны варианты Списать средства немедленно (эквивалентно CHARGE_FULL_PRICE) и Списать средства в следующую дату выставления счета (эквивалентно WITHOUT_PRORATION). Это единственные режимы замены, которые можно использовать при переходе на другой основной план в рамках одной подписки.
Например, если вы предлагаете пользователю, который отменил подписку, но у которого она ещё не закончилась, вернуться на тот же тарифный план, вы можете обработать новую покупку как обычную, не указывая значения в SubscriptionUpdateParams. Система использует режим замены по умолчанию, который вы настроили в подписке, и автоматически обрабатывает переход со старого тарифного плана на новый.
Как переключаться между тарифными планами в подписках или переопределять режим замены по умолчанию
Если пользователь меняет продукт, то есть покупает другую подписку, или если вы хотите переопределить режим замены по умолчанию, укажите пропорциональную ставку во время выполнения в параметрах процесса покупки.
Чтобы правильно указать ReplacementMode в SubscriptionProductReplacementParams или SubscriptionUpdateParams при настройке процесса покупки, учитывайте следующие ограничения:
- При переходе на тарифный план с предоплатой с тарифного плана с предоплатой, автоматическим продлением или рассрочкой, а также при переходе на тарифный план с автоматическим продлением с тарифного плана с автоматическим продлением или рассрочкой можно использовать только режим замены
CHARGE_FULL_PRICE. Если вы укажете другой режим замены, покупка не будет выполнена и пользователь увидит сообщение об ошибке. - При переходе в рамках одной подписки на тарифный план с автоматическим продлением с тарифного плана с предоплатой или автоматическим продлением допустимы режимы пропорционального перерасчета
CHARGE_FULL_PRICEиWITHOUT_PRORATION. Если вы укажете любой другой режим пропорционального пересчета, покупка не будет выполнена и пользователь увидит сообщение об ошибке. - Переход с основного плана с рассрочкой на основной план без рассрочки в рамках одной подписки не разрешен.
- Если вы используете режим замены
KEEP_EXISTINGвSubscriptionProductReplacementParams, чтобы сохранить платеж за товар без изменений, идентификатор старого товара должен совпадать с идентификатором нового. РежимKEEP_EXISTINGне поддерживается вSubscriptionUpdateParams.
Примеры и особенности замены
Чтобы понять, как работает каждый режим пропорционального пересчета, рассмотрим следующий сценарий:
У Сэма есть подписка на онлайн-контент в приложении Country Gardener. У него ежемесячная подписка первого уровня, которая дает доступ только к текстовому контенту. Его абонентская плата составляет 2 доллара США в месяц, а продлевается она первого числа каждого месяца.
15 апреля Сэм решил перейти на годовую подписку второго уровня, которая включает обновления видео и стоит 36 долларов США в год.
При обновлении подписки разработчик выбирает режим пропорционального пересчета. Ниже описано, как каждый из режимов пропорционального пересчета повлияет на подписку Сэма.
WITH_TIME_PRORATION
Подписка первого уровня Сэма сразу же отменяется. Поскольку он оплатил полный месяц (с 1 по 30 апреля), но перешел на другой уровень в середине расчетного периода, половина стоимости подписки (1 доллар США) будет зачислена в счет новой подписки. Однако поскольку новая абонентская плата составляет 36 долларов США в год, баланс в размере 1 доллара США покрывает только 10 дней (с 16 по 25 апреля). Таким образом, 26 апреля с него списывается 36 долларов США за новую подписку и ещё 36 долларов США 26 апреля каждого последующего года.
Вызовите метод PurchasesUpdatedListener сразу после успешной покупки, когда вы сможете получить информацию о ней с помощью метода queryPurchasesAsync(). Ваш сервер сразу же получает уведомление для разработчиков в режиме реального времени SUBSCRIPTION_PURCHASED.
CHARGE_PRORATED_PRICE
Этот режим можно использовать, поскольку цена подписки Уровень 2 за единицу времени (36 долларов США в год = 3 доллара США в месяц) выше, чем цена подписки Уровень 1 за единицу времени (2 доллара США в месяц). Подписка первого уровня Сэма сразу же отменяется. Поскольку он оплатил полный месяц, но использовал только половину, половина месячной подписки (1 доллар США) применяется к его новой подписке. Однако, поскольку новая подписка стоит 36 долларов США в год, оставшиеся 15 дней стоят 1,5 доллара США. Таким образом, с него взимается разница в размере 0,5 доллара США за новую подписку. 1 мая с Сэма списывается 36 долларов США за новый уровень подписки и ещё 36 долларов США 1 мая каждого последующего года.
Вызовите метод PurchasesUpdatedListener сразу после успешной покупки, когда вы сможете получить информацию о ней с помощью метода queryPurchasesAsync(). Ваш сервер сразу же получает уведомление для разработчиков в режиме реального времени SUBSCRIPTION_PURCHASED.
WITHOUT_PRORATION
Подписка уровня 1 сразу же заменяется подпиской уровня 2 без дополнительной платы. 1 мая с пользователя списывается 36 долларов США за новый уровень подписки, и эта сумма будет списываться 1 мая каждого последующего года.
Вызовите метод PurchasesUpdatedListener сразу после успешной покупки, когда вы сможете получить информацию о ней с помощью метода queryPurchasesAsync(). Ваш сервер сразу же получает уведомление для разработчиков в режиме реального времени SUBSCRIPTION_PURCHASED.
DEFERRED
Подписка первого уровня будет действовать до 30 апреля. 1 мая вступает в силу подписка уровня 2, и с Сэма списывается 36 долларов США за новый уровень подписки.
Вызовите метод PurchasesUpdatedListener сразу после успешной покупки, когда вы сможете получить информацию о ней с помощью метода queryPurchasesAsync(). Ваш сервер сразу же получает уведомление для разработчиков в режиме реального времени SUBSCRIPTION_PURCHASED. Обработайте покупку так же, как и любую другую. В частности, убедитесь, что вы подтвердили новую покупку. Обратите внимание, что поле startTime новой подписки заполняется в момент замены, то есть когда истекает срок действия старой подписки. В этот момент вы получите SUBSCRIPTION_RENEWED RTDN для новой подписки. Подробнее о том, как работает ReplacementMode.DEFERRED, читайте в разделе Обработка отложенной замены.
CHARGE_FULL_PRICE
Подписка первого уровня Сэма сразу же отменяется. Его подписка уровня 2 начинается сегодня, и с него списывается 36 долларов США. Поскольку он оплатил полный месяц, но использовал только половину, половина месячной подписки (1 доллар США) применяется к его новой подписке. Поскольку абонентская плата за новую подписку составляет 36 долларов США в год, к сроку обслуживания его подписки будет добавлена 1/36 года (около 10 дней). Таким образом, следующий платеж в размере 36 долларов США будет списан через 1 год и 10 дней. После этого с него будет списываться 36 долларов США в год.
При выборе режима пропорционального пересчета обязательно ознакомьтесь с нашими рекомендациями по замене.
KEEP_EXISTING
У Сэма есть подписка на онлайн-контент в приложении Country Gardener. Он оформил ежемесячную подписку на План 1 для базового контента. Начальная цена подписки составляет 2 доллара США в месяц в течение трех месяцев, а затем – 4 доллара США в месяц. Сэм купил его 1 апреля. В приложении Country Gardener предлагается План 2 – дополнительный специализированный контент за 3 доллара США в месяц. 15 апреля Сэм добавил в свою подписку на приложение Country Gardener тарифный план 2, сохранив при этом тарифный план 1. График платежей Сэма выглядит следующим образом:
- Пропорциональная цена за План 2 – 1, 50 доллара США.Срок оплаты – 15 апреля.
- 5 долларов США в месяц за следующие два месяца (начальная цена за План 1 и обычная цена за План 2).
- Затем ежемесячно будет списываться 7 долларов США.
Как инициировать изменение подписки в приложении
Чтобы предложить пользователям перейти на другой тарифный план, выполните те же действия, что и при запуске процесса покупки. Однако при переходе на другой тарифный план необходимо указать сведения о текущей подписке, будущей подписке (с более высоким или низким уровнем) и режиме замены.
Используйте SubscriptionProductReplacementParams для замены (рекомендуется)
В примере ниже показано, как обновить подписку с помощью SubscriptionProductReplacementParams.
Объект
BillingFlowParams.ProductDetailsParamsтеперь содержит методsetSubscriptionProductReplacementParams(), позволяющий указывать информацию о замене на уровне товара.В
SubscriptionProductReplacementParamsесть два метода задания значений:setOldProductId:Это старый товар, который будет заменен товаром из текущегоProductDetails.setReplacementMode:Это режим замены на уровне товара. Режимы по сути те же, что и вSubscriptionUpdateParams, но сопоставление значений было обновлено.
Существующие параметры обновления уровня покупки
BillingFlowParams.setSubscriptionUpdateParams()должны быть созданы с помощьюsetOldPurchaseToken().После вызова
setSubscriptionProductReplacementParams()для любого изProductDetailsParamsSubscriptionUpdateParams.setSubscriptionReplacementMode()не будет иметь эффекта.
В примере кода ниже показано, как изменить тарифный план с (old_product_1, old_product_2) на (product_1, product_2, product_3). В этом сценарии product_1 заменяет old_product_1, product_2 заменяет old_product_2, а product_3 добавляется в подписку немедленно.
Kotlin
val billingClient: BillingClient = this.billingClient val replacementModeForBasePlan: Int = SubscriptionProductReplacementParams.ReplacementMode.KEEP_EXISTING val replacementModeForAddon: Int = SubscriptionProductReplacementParams.ReplacementMode.CHARGE_PRORATED_PRICE val purchaseTokenOfExistingSubscription: String = "your_old_purchase_token" // ProductDetails instances obtained from queryProductDetailsAsync(); val productDetailsParams1 = ProductDetailsParams.newBuilder() .setProductDetails(productDetails1) // Required: Set the ProductDetails object .setSubscriptionProductReplacementParams( SubscriptionProductReplacementParams.newBuilder() .setOldProductId("old_product_id_1") .setReplacementMode(replacementModeForBasePlan) .build() ) .build() val productDetailsParams2 = ProductDetailsParams.newBuilder() .setProductDetails(productDetails2) // Required: Set the ProductDetails object .setSubscriptionProductReplacementParams( SubscriptionProductReplacementParams.newBuilder() .setOldProductId("old_product_id_2") .setReplacementMode(replacementModeForAddon) .build() ) .build() // Example for a third item without replacement params val productDetailsParams3 = ProductDetailsParams.newBuilder() .setProductDetails(productDetails3) // Required: Set the ProductDetails object .build() val newProductDetailsList = listOf( productDetailsParams1, productDetailsParams2, productDetailsParams3 ) val billingFlowParams = BillingFlowParams.newBuilder() .setSubscriptionUpdateParams( SubscriptionUpdateParams.newBuilder() .setOldPurchaseToken(purchaseTokenOfExistingSubscription) .build() ) .setProductDetailsParamsList(newProductDetailsList) .build() // To launch the billing flow: billingClient.launchBillingFlow(activity, billingFlowParams)
Java
BillingClient billingClient = …; int replacementModeForBasePlan =…; int replacementModeForAddon =…; // ProductDetails obtained from queryProductDetailsAsync(). ProductDetailsParams productDetails1 = ProductDetailsParams.newBuilder() .setSubscriptionProductReplacementParams( SubscriptionProductReplacementParams.newBuilder() .setOldProductId("old_product_id_1") .setReplacementMode(replacementModeForBasePlan)) .build(); ProductDetailsParams productDetails2 = ProductDetailsParams.newBuilder() .setSubscriptionProductReplacementParams( SubscriptionProductReplacementParams.newBuilder() .setOldProductId("old_product_id_2") .setReplacementMode(replacementModeForAddon)) .build(); ProductDetailsParams productDetails3 = ...; ArrayListnewProductDetailsList = new ArrayList<>(); newProductDetailsList.add(productDetails1); newProductDetailsList.add(productDetails2); newProductDetailsList.add(productDetails3); BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder() .setSubscriptionUpdateParams( SubscriptionUpdateParams.newBuilder() .setOldPurchaseToken(purchaseTokenOfExistingSubscription) .build()) .setProductDetailsParamsList(productDetailsList) .build(); billingClient.launchBillingFlow(billingFlowParams);
Как задать SubscriptionUpdateParams для замены (устарело)
В примере ниже показано, как обновить подписку с помощью SubscriptionUpdateParams.
Kotlin
val offerToken = productDetails .getSubscriptionOfferDetails(selectedOfferIndex) .getOfferToken() val billingParams = BillingFlowParams.newBuilder().setProductDetailsParamsList( listOf( BillingFlowParams.ProductDetailsParams.newBuilder() .setProductDetails(productDetails) .setOfferToken(offerToken) .build() ) ).setSubscriptionUpdateParams( BillingFlowParams.SubscriptionUpdateParams.newBuilder() .setOldPurchaseToken("old_purchase_token") .setSubscriptionReplacementMode( BillingFlowParams.ReplacementMode.CHARGE_FULL_PRICE ) .build() ).build() billingClient.launchBillingFlow( activity, billingParams ) // ...
Java
String offerToken = productDetails .getSubscriptionOfferDetails(selectedOfferIndex) .getOfferToken(); BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder() .setProductDetailsParamsList( ImmuableList.of( ProductDetailsParams.newBuilder() // fetched using queryProductDetailsAsync .setProductDetails(productDetails) // offerToken can be found in // ProductDetails=>SubscriptionOfferDetails .setOfferToken(offerToken) .build())) .setSubscriptionUpdateParams( SubscriptionUpdateParams.newBuilder() // purchaseToken can be found in Purchase#getPurchaseToken .setOldPurchaseToken("old_purchase_token") .setSubscriptionReplacementMode(ReplacementMode.CHARGE_FULL_PRICE) .build()) .build(); BillingResult billingResult = billingClient.launchBillingFlow(activity, billingFlowParams); // ...
Рекомендации по замене
В таблице ниже приведены различные сценарии пропорционального распределения и наши рекомендации для каждого из них.
| Сценарий | Рекомендуемый режим замены | Результат |
|---|---|---|
| Переход на более дорогой уровень | CHARGE_PRORATED_PRICE |
Пользователь сразу получает доступ к новому контенту, а расчетный период остается прежним. |
| Переход на более дешевый уровень | DEFERRED |
Пользователь уже оплатил более дорогой уровень, поэтому он сохраняет доступ до следующей даты выставления счета. |
| Переход на более дорогую версию во время бесплатного пробного периода с сохранением пробного периода | WITHOUT_PRORATION |
Пользователь переходит на более высокий уровень на оставшуюся часть пробного периода без дополнительной платы. |
| Переход на платную версию во время бесплатного пробного периода – прекращение доступа к бесплатной пробной версии | CHARGE_PRORATED_PRICE |
Пользователь сразу получает доступ к новому уровню, а оставшаяся часть бесплатного пробного периода переносится. Перенесенная стоимость рассчитывается на основе цены основного плана. |
| График платежей для некоторых элементов подписки остается неизменным, в то время как другие элементы добавляются в подписку с дополнениями или удаляются из нее. | KEEP_EXISTING |
Пользователь продолжает платить старую цену за неизмененный объект. Новые объекты добавляются сразу. Другие старые объекты можно заменить, указав режим замены, или удалить. |
Как обрабатывать покупки при изменении подписки
Изменение тарифного плана считается новой покупкой. После успешного завершения сценария оплаты его нужно обработать и подтвердить. Помимо обработки новой покупки, вам нужно отменить заменяемую покупку.
Поведение в приложении такое же, как и при любой новой покупке. Приложение получает результат новой покупки в PurchasesUpdatedListener, а сама покупка становится доступна в queryPurchasesAsync.
Google Play Developer API возвращает linkedPurchaseToken в ресурсе подписки, когда покупка заменяет существующую. Чтобы узнать подробности о замене на уровне товара, проверьте itemReplacement в разделе SubscriptionPurchaseLineItem в новой покупке.
Кроме того, вы можете использовать поле offerPhase, чтобы определить текущий этап специального предложения (например, период пропорциональной оплаты или бесплатный пробный период) для новой подписки и предоставить пользователям персонализированные возможности. Обязательно аннулируйте токен, указанный в параметре linkedPurchaseToken, чтобы старый токен не использовался для доступа к вашим сервисам. Информацию о том, как обрабатывать покупки, связанные с переходом на более дорогую или дешевую подписку, вы найдете в разделе Переход на более дорогую или дешевую подписку и повторное оформление.
Получив новый токен покупки, выполните ту же процедуру, что и при проверке нового токена покупки. Обязательно подтверждайте такие покупки с помощью метода BillingClient.acknowledgePurchase() из библиотеки Google Play Платежей или метода Purchases.subscriptions:acknowledge из Google Play Developer API.
Как обрабатывать отложенную замену
Режим отложенной замены позволяет пользователю использовать оставшееся право в старом плане, прежде чем перейти на новый.
Если вы используете ReplacementMode.DEFERRED для новой покупки, queryPurchasesAsync() возвращает новый токен покупки после процесса покупки, который остается связанным со старым продуктом до тех пор, пока не произойдет отложенная замена в следующую дату продления, после чего возвращается новый продукт.
Раньше для этого можно было использовать метод
ProrationMode.DEFERRED, но ProrationMode.DEFERRED он был удален из библиотеки Play
Платежей версии 6. В таблице ниже показано, в чем заключаются различия.
Время |
ProrationMode.DEFERRED (поддержка прекращена) |
ReplacementMode.DEFERRED |
Сразу после успешного завершения процесса покупки (приложение) |
После покупки вызывается метод Право на использование старого плана сохраняется до следующей даты продления. Чтобы приложение предоставляло правильное право, Новый токен покупки не отображается, поэтому его нельзя обработать. |
После покупки вызывается метод
Появится новый токен покупки, который нужно обработать с учетом того, когда должна произойти замена. |
Сразу после успешного завершения процесса покупки (внутренний интерфейс) |
Уведомление SUBSCRIPTION_PURCHASED не отправляется после покупки. Бэкенд ещё не знает о новой покупке. |
Уведомление SUBSCRIPTION_PURCHASED со старым идентификатором product_id отправляется сразу после процесса покупки для нового токена. Вызов метода purchases.subscriptionsv2.get с новым токеном покупки возвращает покупку со значением startTime, указывающим на время покупки, и двумя строками:
Для старого токена покупки отправляется уведомление SUBSCRIPTION_EXPIRED. Если вызвать метод purchases.subscriptionsv2.get со старым токеном покупки, он будет показан как недействительный. Право на доступ к контенту по старому плану переносится на новую покупку на оставшийся срок. |
При замене – первое продление после процесса покупки (приложение) |
Теперь у вас есть новый токен покупки, который нужно обработать. |
Новая покупка должна быть обработана сразу после успешного завершения процесса покупки, поэтому приложению не нужно выполнять никаких специальных действий, кроме предоставления нужного права доступа. |
При замене – первое продление после покупки (внутренний процесс) |
Теперь новую покупку можно обработать и подтвердить, когда будет отправлено первое уведомление SUBSCRIPTION_RENEWED. Поле |
Новая покупка была обработана и подтверждена, когда для нового токена покупки было отправлено уведомление SUBSCRIPTION_PURCHASED, которое было записано как startTime. При использовании ReplacementMode.DEFERRED первое продление выполняется стандартным образом, и вам не нужно настраивать специальную логику для замен. При вызове метода purchases.subscriptionsv2.get с новым токеном покупки возвращается покупка с двумя строками:
|
Вместо устаревшего режима ProrationMode.DEFERRED теперь следует использовать ReplacementMode.DEFERRED. Он работает так же, но позволяет управлять покупкой более согласованно с другими новыми покупками.
Управление клиентами
Уведомления для разработчиков в режиме реального времени позволяют сразу узнавать, когда пользователь отменяет подписку. Если пользователь отменил подписку, но срок ее действия ещё не истек, вы можете отправить ему push-уведомление или сообщение в приложении с предложением возобновить подписку.
Чтобы снизить количество отмен, инициированных в Google Play, вы можете настроить специальные предложения. Google Play показывает предложение по удержанию подписчикам, которые соответствуют требованиям, когда они пытаются отменить подписку. Если они принимают предложение, подписка продолжается по сниженной цене.
Если пользователь отменил подписку, вы можете попытаться вернуть его в приложении или через Google Play. В таблице ниже описаны различные сценарии подписки, а также связанные с ними действия по возврату и требования к приложению.
| До окончания срока действия подписки | После окончания срока действия подписки | |||
| В приложении | В Google Play | В приложении | В Google Play | |
| Функция возврата клиентов | Подписка в приложении | Восстановить | Подписка в приложении | Подпишитесь снова |
| Пользователь проходит процесс оформления заказа | Да | Нет | Да | Да |
| Подписка пользователя остается связанной с тем же SKU | Пользователь может оформить подписку на ту же или другую версию продукта. | Да | Пользователь может оформить подписку на ту же или другую версию продукта. | Да |
| Создание нового токена покупки | Да | Нет | Да | Да |
| Включено по умолчанию | Нет | Да, поддержка обязательна для всех разработчиков | Нет |
Приложения без библиотеки Google Play Платежей версии 2.0 и выше: нет. Приложения с библиотекой Платежей 2.0 и более поздних версий: да. Разработчики могут отказаться от этого в Play Console. |
| Когда с пользователя списываются средства |
Если используется тот же SKU: конец текущего расчетного периода. Если используется другой SKU, зависит от режима пропорционального распределения. |
Конец текущего расчетного периода | Незамедлительно | Незамедлительно |
| Требуется реализация | Добавьте в приложение интерфейс для повторной регистрации. |
Как отслеживать изменения в статусе подписки Ссылка на контент в Google Play |
Добавьте в приложение интерфейс для повторной регистрации | Как обрабатывать покупки вне приложения |
До окончания срока действия подписки – в приложении
Если подписка отменена, но срок ее действия ещё не истек, вы можете разрешить пользователям восстановить ее в приложении. Для этого нужно применить тот же процесс покупки контента, что и для новых подписчиков. Убедитесь, что в интерфейсе отражается наличие у пользователя подписки. Например, вы можете показать пользователю текущую дату окончания срока действия и цену за продление, а также кнопку Повторно активировать.
В большинстве случаев вы захотите предложить пользователю ту же цену и SKU, на которые он уже был подписан, как показано ниже:
- Инициируйте новую покупку подписки с тем же кодом SKU.
- Новая подписка заменяет старую и продлевается в ту же дату. Старая подписка сразу помечается как истекшая.
- Например, у пользователя есть подписка на музыкальное приложение, которая истекает 1 августа. 10 июля он снова оформляет подписку на месяц по той же цене. Новая подписка активируется немедленно, а ее стоимость рассчитывается пропорционально оставшемуся балансу. Дата продления остается прежней – 1 августа.
Если вы хотите предложить другую цену, например новый бесплатный пробный период или скидку для возвращения пользователя, вы можете предложить ему другой SKU.
- Инициируйте переход на более дорогой или дешевый план с другим SKU, используя режим замены
WITHOUT_PRORATION. - Новая подписка заменяет старую и продлевается в ту же дату. В дату окончания действия подписки с пользователя взимается плата за новый SKU, включая начальные цены. Если старая подписка была создана с использованием обфусцированного идентификатора аккаунта, то для повышения и понижения уровня подписки в
BillingFlowParamsнужно передать тот же идентификатор. - Например, у пользователя есть подписка на музыкальное приложение, которая истекает 1 августа. 10 июля он снова оформляет годовую подписку по начальной цене. Новая подписка активируется немедленно, и 1 августа с пользователя списывается начальная цена.
- Если вы решите включить в SKU для возврата пользователей бесплатный пробный период или начальную цену, убедитесь, что пользователь соответствует требованиям. Для этого в Google Play Console снимите флажок Разрешить один бесплатный пробный период для каждого приложения, который ограничивает пользователя получением одного бесплатного пробного периода для каждого приложения.
Получив токен покупки, обработайте покупку так же, как и в случае с новой подпиской. Кроме того, Google Play Developer API возвращает linkedPurchaseToken в ресурсе подписки. Обязательно аннулируйте токен, указанный в linkedPurchaseToken, чтобы никто не мог использовать его для доступа к вашим сервисам.
До окончания срока действия подписки – в Google Play
Пока подписка отменена, но все ещё активна, пользователи могут восстановить ее в центре подписок Google Play, нажав Подписаться снова (ранее – Восстановить). При этом токен подписки и покупки не меняется.
Подробнее о восстановлении подписок…
После окончания срока действия подписки – в приложении
Вы можете разрешить пользователям с истекшей подпиской возобновлять ее в приложении, используя тот же процесс покупки, что и для новых подписчиков. объявлений.
- Чтобы предложить пользователям скидку, вы можете создать идентификатор товара со специальной ценой на подписку, также называемый SKU для возврата пользователей. Вы можете предоставить предложение в приложении или уведомить о нем пользователя за пределами приложения, например по электронной почте.
- Чтобы запустить подписку для возврата пользователей, запустите процесс покупки в приложении для Android, используя библиотеку Google Play Платежей. Процесс аналогичен оформлению новой подписки, но вы можете определить SKU, доступный пользователю.
- Если вы решите включить бесплатный пробный период или начальную цену в SKU для возвращения пользователей, убедитесь, что пользователь соответствует требованиям. Для этого снимите флажок Разрешить один бесплатный пробный период для каждого приложения в Google Play Console. Это позволит пользователю получить только один бесплатный пробный период для каждого приложения.
- Если пользователь повторно оформляет подписку на тот же SKU, он больше не имеет права на бесплатный пробный период или начальную цену. Убедитесь, что это отражено в интерфейсе.
Получив токен покупки, обработайте покупку так же, как и в случае с новой подпиской. Вы не получите linkedPurchaseToken в ресурсе подписки.
После окончания срока действия подписки – в Google Play
Если эта функция включена, пользователи могут повторно оформить подписку на тот же SKU в течение года после ее окончания. Для этого нужно нажать Подписаться снова в центре подписок Google Play. Это приведет к созданию новой подписки и токена покупки.
Повторное оформление подписки считается покупкой вне приложения, поэтому следуйте рекомендациям по подтверждению таких покупок на сервере.
Продвижение подписки
Вы можете создать промокоды, чтобы предоставить выбранным пользователям расширенный бесплатный пробный период для существующей подписки. Подробнее о промокодах…
Перед началом бесплатного пробного периода Google Play проверяет, есть ли у пользователя действительный способ оплаты. Некоторые пользователи могут увидеть эту проверку как удержание или списание средств с их способа оплаты. Это временная мера, и позже средства будут возвращены.
После окончания пробного периода с пользователя взимается полная стоимость подписки.
Если пользователь отменит подписку в течение бесплатного пробного периода, она останется активной до его окончания, и по его завершении плата взиматься не будет.
Как отложить оплату для подписчика
Вы можете продлить период действия подписки с помощью метода subscriptionsv2.defer. Если вы откладываете подписку с дополнениями, все элементы в ней откладываются на один и тот же срок. В течение этого периода пользователь сохраняет полный доступ к контенту, но плата не взимается. Дата продления подписки будет обновлена.
Для предоплаченных планов можно использовать API отложенных платежей, чтобы отложить срок окончания действия.
Отложенная оплата позволяет:
- Предоставьте пользователям бесплатный доступ в качестве специального предложения, например одну неделю бесплатно при покупке фильма.
- Предоставьте клиентам бесплатный доступ в качестве жеста доброй воли.
Выставление счета можно отложить на срок от одного дня до одного года за один вызов API. Чтобы отложить оплату на более длительный срок, вы можете вызвать API ещё раз до наступления новой даты оплаты.
Например, у Дарьи есть ежемесячная подписка на онлайн-контент в приложении Fishing Quarterly. Обычно с нее списывается 1,25 фунта стерлингов первого числа каждого месяца. В марте она приняла участие в онлайн-опросе издателя приложения. Издатель предоставляет ей шесть бесплатных недель, откладывая следующий платеж до 15 мая, то есть на шесть недель после ранее запланированной даты выставления счета 1 апреля.
- За апрель и начало мая плата не взимается, но доступ к контенту сохраняется. 15 мая с нее списывается обычная стоимость подписки за месяц – 1, 25 фунта стерлингов. Теперь следующая дата продления – 15 июня.
При отсрочке вы можете уведомить пользователя по электронной почте или в приложении о том, что дата оплаты изменилась.
Что делать, если платеж был отклонен
Если при продлении подписки возникнут проблемы с оплатой, Google будет периодически пытаться продлить подписку в течение некоторого времени, прежде чем отменить ее. Подписку можно восстановить, пока длится льготный период и временная блокировка аккаунта. В течение этого времени Google отправляет пользователю электронные письма и уведомления с предложением обновить способ оплаты.
Если платеж отклонен, начинается льготный период (если он настроен). В течение льготного периода у пользователя должен оставаться доступ к возможностям подписки.
Если пользователь не решит проблему с оплатой до окончания льготного периода, может начать действовать временная блокировка аккаунта. Во время временной блокировки аккаунта пользователям должны быть недоступны возможности подписки.
В Google Play Console можно указать длительность льготного периода и временной блокировки аккаунта для каждого основного плана с автоматическим продлением. Если длительность какого-либо периода будет меньше значения по умолчанию, может сократиться число подписок, продленных после проблем с оплатой.
Чтобы повысить вероятность восстановления подписки после отклонения платежа, вы можете сообщить пользователю о проблеме с оплатой и попросить его устранить ее.
Вы можете сделать это самостоятельно, как описано в разделах Льготный период и Блокировка аккаунта, или реализовать API сообщений в приложении, чтобы Google показывал пользователям сообщение в вашем приложении.
Если возникнет проблема с оплатой, Google Play может показать пользователю уведомление. Чтобы упростить этот процесс, вы можете использовать функцию сообщений в приложении и информировать пользователей о предстоящих платежах. Если вы включили сообщения в приложении, то в течение льготного периода и временной блокировки аккаунта пользователь будет видеть сообщение о проблемах с оплатой раз в день. Это позволяет пользователям устранить проблему с оплатой, не выходя из приложения. Подробнее о сообщениях в приложении…
Сообщения в приложении
Если вы включили сообщения в приложении с помощью InAppMessageCategoryId.TRANSACTIONAL, Google Play будет показывать пользователям сообщения, когда возникают проблемы с оплатой или когда они не подтвердили повышение цены с запросом согласия.
Рекомендуем вызывать этот API каждый раз, когда пользователь открывает приложение, чтобы определить, нужно ли показывать сообщение.
Если пользователь успешно восстановил подписку или подтвердил повышение цены, вы получите код ответа SUBSCRIPTION_STATUS_UPDATED и токен покупки. Затем используйте этот токен покупки, чтобы вызвать Google Play Developer API и обновить статус подписки в приложении.
Интеграция сообщений в приложении
Чтобы показывать пользователям сообщения в приложении, используйте BillingClient.showInAppMessages().
Ниже приведен пример запуска процесса показа сообщения в приложении.
Kotlin
val inAppMessageParams = InAppMessageParams.newBuilder() .addInAppMessageCategoryToShow(InAppMessageCategoryId.TRANSACTIONAL) .build() // Note: To display the in-app message, PBL requires an activity instance that // can provide a valid window token. This token is necessary for the Play Store // to display the message overlay correctly on top of the application's window. // The passed Activity must be in a state where its window is created and // attached to the WindowManager. billingClient.showInAppMessages( activity, inAppMessageParams, object : InAppMessageResponseListener { override fun onInAppMessageResponse(inAppMessageResult: InAppMessageResult) { if (inAppMessageResult.responseCode == InAppMessageResponseCode.NO_ACTION_NEEDED) { // The flow has finished and there is no action needed from developers. } else if (inAppMessageResult.responseCode == InAppMessageResponseCode.SUBSCRIPTION_STATUS_UPDATED ) { // The subscription status changed. For example, a subscription // is recovered from a suspended state, or a user confirms a // price increase. Developers should expect the purchase // token to be returned with this response code and use // the purchase token with the Google Play Developer API. } } } )
Java
InAppMessageParams inAppMessageParams = InAppMessageParams.newBuilder() .addInAppMessageCategoryToShow(InAppMessageCategoryId.TRANSACTIONAL) .build(); // Note: To display the in-app message, PBL requires an activity instance that // can provide a valid window token. This token is necessary for the Play Store // to display the message overlay correctly on top of the application's window. // The passed Activity must be in a state where its window is created and // attached to the WindowManager. billingClient.showInAppMessages(activity, inAppMessageParams, new InAppMessageResponseListener() { @Override public void onInAppMessageResponse(InAppMessageResult inAppMessageResult) { if (inAppMessageResult.responseCode == InAppMessageResponseCode.NO_ACTION_NEEDED) { // The flow has finished and there is no action needed from developers. } else if (inAppMessageResult.responseCode == InAppMessageResponseCode.SUBSCRIPTION_STATUS_UPDATED) { // The subscription status changed. For example, a subscription // is recovered from a suspended state, or a user confirms a // price increase. Developers should expect the purchase // token to be returned with this response code and use // the purchase token with the Google Play Developer API. } } });
Обработка отмен и ожидающих статусов
В этом разделе объясняется, как обрабатывать отмененные или отозванные подписки, а также как управлять подписками, которые переходят в состояние ожидания в процессе покупки.
Отмена или отзыв
С помощью Google Play Developer API можно отменить или аннулировать подписку. Эта функция также доступна в Google Play Console.
Отмена. Пользователи могут отменить подписку в Google Play. Вы также можете предоставить пользователям возможность отменить подписку в вашем приложении или на сайте. Приложение должно обрабатывать такие отмены, как описано в разделе Отмены.
Отмена. Пользователь сразу теряет доступ к подписке. Например, если из-за технической ошибки пользователь не смог получить доступ к продукту и больше не хочет им пользоваться. Приложение должно обрабатывать такие отмены, как описано в разделе Отзыв подписки.
В таблице ниже показаны различия между отменой и отзывом.
| Отмена продления | Как закрыть доступ | |
| Отмена | Да | Нет |
| Отменить | Да | Да |
Как обрабатывать транзакции в обработке по подпискам
Транзакции в обработке могут возникать при первой покупке, пополнении баланса, переходе на более дорогой или дешевый тарифный план. Покупка подписки начинается со статуса SUBSCRIPTION_STATE_PENDING, а затем переходит в статус SUBSCRIPTION_STATE_ACTIVE. Если срок действия транзакции истек или она была отменена пользователем, ей присваивается статус SUBSCRIPTION_STATE_PENDING_PURCHASE_EXPIRED. Обновлять права пользователя нужно только после завершения транзакции.
Изменение состояния подписки при первой покупке с транзакциями в обработке происходит просто. Когда пользователь инициирует транзакцию в обработке, ваше приложение получает Purchase со статусом PENDING. После завершения транзакции приложение снова получает объект Purchase со статусом PURCHASED. Клиенту RTDN отправляется сообщение SubscriptionNotification с типом SUBSCRIPTION_PURCHASED. Выполните стандартную процедуру проверки покупки, предоставьте пользователю доступ к контенту и подтвердите покупку. Если срок действия транзакции истек или она была отменена, вашему клиенту RTDN отправляется сообщение SubscriptionNotification с типом SUBSCRIPTION_PENDING_PURCHASE_CANCELED. В таких случаях пользователь не должен был получить доступ к контенту.
Пополнение, переход на более дорогой или дешевый тариф с транзакциями в обработке включает изменение состояния как для старой, так и для новой подписки. Когда пользователь инициирует ожидающую транзакцию пополнения, перехода на другой план или уровень, ваше приложение получает объект Purchase для старой подписки с объектом PendingPurchaseUpdate. В этот момент у пользователя все ещё есть старая подписка, а новая пока не оформлена. Вызов методов getProducts() и getPurchaseToken() для объекта PendingPurchaseUpdate возвращает идентификаторы товаров и токен покупки новой подписки. Когда транзакция будет завершена, ваше приложение получит объект Purchase с токеном покупки верхнего уровня, заданным для новой подписки, и статусом PURCHASED. На ваш клиент RTDN отправляется сообщение SubscriptionNotification с типом SUBSCRIPTION_PURCHASED. Только в этот момент вы должны заменить старый токен покупки новым и обновить доступ пользователя к контенту. Если срок действия транзакции истек или она была отменена, вашему клиенту RTDN отправляется сообщение SubscriptionNotification с типом SUBSCRIPTION_PENDING_PURCHASE_CANCELED. В таких случаях у пользователя должен оставаться доступ к контенту старой подписки.