Работа с оплатами подписок в маркетплейсе

Передача информации об оплате подписки на ваш сервис

При активации интеграции, ваше приложение будет подключено в филиал с триальной подпиской. Длительность триальной подписки вы указываете в личном кабинете в разделе «Монетизация».

При оплате подписки на ваш сервис, необходимо будет по API передать в YCLIENTS информацию об оплате. Описание запроса об оплате подписки см. в API документации.

Если до конца триала вы не передадите YCLIENTS информацию об оплате подписки, то интеграция будет автоматически отключена в течение суток.

Данные об оплате подписки необходимо отправлять при каждой оплате подписки.

Автоматическое отключение интеграции

Автоматическое отключение интеграции подразумевает, что:

• вы не сможете больше обращаться к API отключенного филиала;
• будет прекращена отправка событий на указанные вами адреса вебхуков.

Автоматическое отключение интеграции происходит в двух случаях:

• Если до окончания триальной подписки вы не передадите YCLIENTS информацию о том, что пользователь оплатил подписку на ваш сервис.
• Если к дате окончания оплаченной ранее подписки не будет передана информация об оплате подписки на следующий период.

Возобновление подписки

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

Отмена оплаченной подписки и возврат

Для осуществления возврата и отключения интеграции для филиала вы можете отправить запрос к API возвратов.

Если вы осуществите возврат по активной подписке филиала, то интеграция на стороне YCLIENTS будет отключена в течение часа — из филиала будет удален системный пользователь и отключится отправка вебхуков.

Для возврата по транзакции вам необходимо передать ID транзакции, по которой вы хотите оформить возврат. ID транзакции вы получаете в ответе API при отправке информации об оплате подписки на ваш сервис.

Изменение стоимости/длительности уже оплаченной подписки

Если вам необходимо изменить стоимость или длительность оплаченной подписки, то вам необходимо:

• Отменить существующую оплату.
• Отправить по API новую информацию об оплате и длительности подписки (или нескольких подписок: одна со старой ценой, действующая до момента повышения цены на подписку, а вторая с новой ценой, действующей с момента повышения цены).