Передача информации об оплате подписки на ваш сервис
При активации интеграции ваше приложение подключается к филиалу с пробной подпиской. Длительность пробной подписки вы указываете в личном кабинете в разделе «Монетизация».
При оплате подписки на ваш сервис нужно отправить информацию об оплате в Altegio через API — описание запроса об оплате подписки см. в API-документации.
Если к концу пробного периода вы не передадите Altegio информацию об оплате подписки, интеграция автоматически отключится в течение 24 часов.
Данные об оплате подписки нужно отправлять при каждой оплате подписки.
Автоотключение интеграции
Автоотключение интеграции означает, что:
- вы больше не сможете обращаться к API отключённого филиала;
- прекратится отправка событий на указанные вами адреса вебхуков.
Интеграция автоматически отключается в двух случаях:
- если до конца пробной подписки вы не отправите в Altegio информацию о том, что пользователь оплатил подписку на ваш сервис;
- если к дате окончания ранее оплаченной подписки не передана информация об оплате подписки на следующий период.
Возобновление подписки
Если интеграция была отключена автоматически, то при получении запроса об оплате подписки она активируется обратно — системный пользователь снова появится в филиале, а ваши адреса вебхуков снова добавятся в филиал.
Отмена оплаченной подписки и возврат средств
Чтобы сделать возврат и отключить интеграцию для филиала, отправьте запрос в API возвратов.
Если вы делаете возврат по активной подписке филиала, интеграция на стороне Altegio отключится в течение часа — системный пользователь будет удалён из филиала, а отправка вебхуков прекратится.
Чтобы вернуть средства по транзакции, нужно передать ID транзакции, по которой хотите оформить возврат. ID транзакции вы получаете в ответе API при отправке информации об оплате подписки.
Изменение стоимости/длительности уже оплаченной подписки
Если нужно изменить стоимость или длительность оплаченной подписки, нужно:
- отменить существующий платёж;
- отправить через API новую информацию об оплате и длительности подписки (или нескольких подписок: одну со старой ценой — действует до повышения цены, вторую с новой ценой — действует с момента повышения цены).