Поделиться через


Управление жизненным циклом подписки SaaS

Коммерческая платформа управляет всем жизненным циклом подписки SaaS после покупки пользователем. Он использует целевую страницу, API выполнения, API операций и веб-перехватчик в качестве механизма для управления фактической активацией подписки SaaS, использованием, обновлениями и отменой. Счет конечного пользователя основан на состоянии подписки SaaS, поддерживаемой корпорацией Майкрософт.

Состояния подписки SaaS

На следующей схеме показаны состояния подписки SaaS и применимые действия.

схема, показывающая жизненный цикл программного обеспечения как подписка на службу в Marketplace.

Приобретенный, но еще не активирован (PendingFulfillmentStart)

После того как конечный пользователь или поставщик облачных решений (CSP) приобретает предложение SaaS на коммерческой платформе, издатель уведомляется о покупке. Затем издатель может создать и настроить новую учетную запись SaaS на стороне издателя для конечного пользователя.

Чтобы создать учетную запись, выполните приведенные действия.

  1. Клиент выбирает настроить учетную запись теперь кнопку, доступную для предложения SaaS после успешной покупки в Microsoft AppSource или на портале Azure. Кроме того, клиент может использовать кнопку Настроить теперь в сообщении электронной почты, которую они получат вскоре после покупки.
  2. Затем корпорация Майкрософт уведомляет партнера о покупке, открыв URL-адрес целевой страницы с параметром токена (маркер идентификации покупки из коммерческой платформы) на новой вкладке браузера.

Примером такого вызова является https://contoso.com/signup?token=<blob>, но URL-адрес целевой страницы для этого предложения SaaS в Центре партнеров настроен как https://contoso.com/signup. Этот маркер предоставляет издателю идентификатор, который однозначно идентифицирует покупку SaaS и клиента.

Кончик

Не включайте символ знака фунта (#) в URL-адрес целевой страницы. В противном случае клиенты не могут получить доступ к целевой странице. Издатель имеет 30 дней для разрешения ресурса, если состояние PendingFulfillmentStart. В противном случае ресурс недействим. Так как цикл выставления счетов не был инициирован и соответствующая покупка не выставляется, состояние изменится на отмена подписки. Клиент не взимается за покупку.

Важный

URL-адрес целевой страницы должен работать весь день, каждый день и готов получать новые звонки от Корпорации Майкрософт. Если целевая страница становится недоступной, клиенты не смогут зарегистрироваться в службе SaaS и начать использовать ее.

Затем издатель должен передать маркер в корпорацию Майкрософт, вызвав API разрешения SaaSи введя маркер в качестве значения параметра x-ms-marketplace-token header. В результате вызова API разрешения маркер обменивается сведениями о покупке SaaS, например уникальном идентификаторе покупки, идентификаторе приобретенного предложения и идентификаторе плана.

На целевой странице клиент должен войти в новую или существующую учетную запись SaaS с помощью единого входа Microsoft Entra.

Заметка

Издатель не уведомляется о покупке SaaS до тех пор, пока клиент не инициирует процесс настройки с стороны Майкрософт.

Издатель должен реализовать единый вход, чтобы обеспечить взаимодействие с пользователем, необходимое корпорацией Майкрософт для этого потока. Не забудьте использовать мультитенантное приложение Microsoft Entra и разрешить рабочие и учебные учетные записи или личные учетные записи Майкрософт при настройке единого входа. Это требование применяется только к целевой странице для пользователей, которые перенаправляются в службу SaaS при входе с учетными данными Майкрософт. Единый вход не требуется для всех входов в службу SaaS.

Заметка

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

После входа клиент должен завершить настройку SaaS на стороне издателя. Затем издатель должен вызвать API активации подписки , чтобы отправить сигнал в Azure Marketplace о завершении подготовки учетной записи SaaS. Это действие запускает цикл выставления счетов клиента. Если вызов API активации подписки не выполнен успешно, клиент не взимается за покупку.

диаграмме с вызовами A P для сценария подготовки.

Покупатель и владелец учетной записи выставления счетов получают сообщение электронной почты, запрашивающее их для настройки учетной записи.

Заметка

Издатель имеет 30 дней для разрешения ресурса, если состояние PendingFulfillmentStart. В противном случае ресурс является недействительным, так как цикл выставления счетов не был инициирован, и соответствующая покупка не выставляется. Состояние изменяется на Отмена подписки. Клиент не взимается за покупку.

Активный (подписка)

активные (подписанные) — это устойчивое состояние подготовленной подписки SaaS. После обработки на стороне Майкрософт вызов API активации подписки активации подписки подписка помечается как подписка. Теперь клиент может использовать службу SaaS на стороне издателя и выставляется счет.

Если подписка SaaS уже активна, клиент может выбрать управление интерфейсом SaaS на портале Azure или в Центре администрирования Microsoft 365. Это действие также приводит к тому, что корпорация Майкрософт вызовет URL-адрес целевой страницы с параметром маркера , как происходит в потоке активации. Издатель должен различать новые покупки и управление существующими учетными записями SaaS и соответствующим образом обрабатывать этот URL-адрес целевой страницы.

Уведомление о активации отправляется как покупателю, так и владельцу учетной записи выставления счетов.

Обновление (подписка)

Это действие означает, что обновление существующей активной подписки SaaS обрабатывается корпорацией Майкрософт и издателем. Обновления инициируют:

  • Клиент из коммерческой платформы.
  • CSP из коммерческой платформы.
  • Клиент с сайта SaaS издателя (но не для покупок, сделанных CSP).

Для подписки SaaS доступны два типа обновлений:

  • Обновите план, когда клиент выбирает другой план для подписки.
  • Обновите количество, когда клиент изменяет количество приобретенных лицензий для подписки.

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

Обновление, инициированное из коммерческой платформы

В этом потоке клиент изменяет план подписки или количество лицензий на портале Azure или Центре администрирования Microsoft 365.

  1. После ввода обновления корпорация Майкрософт вызовет URL-адрес веб-перехватчика издателя, настроенный в поле веб-перехватчика подключения подключения на странице Технической конфигурации в Центре партнеров с соответствующим значением для действий и других соответствующих параметров.
  2. Сторона издателя должна внести необходимые изменения в службу SaaS и уведомить Корпорацию Майкрософт о завершении, вызвав состояние обновления API операций.
  3. Если исправление отправляется с состояние, процесс обновления не завершается на стороне Майкрософт. Подписка SaaS сохраняет существующий план и количество лицензий.

Заметка

Издатель должен вызвать PATCH, чтобы обновить API операций с ответом на сбой и успешность в течение 10-секундного периода времени после получения уведомления веб-перехватчика. Если состояние операции PATCH не получено в течение 10 секунд, план изменений автоматически исправлен в качестве успешного.

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

диаграмме с вызовами A P для обновления, инициированного Marketplace.

Обновление, инициированное издателем

В этом потоке клиент изменяет план подписки или количество лицензий, приобретенных самой службой SaaS.

  1. Перед выполнением запрошенного изменения на стороне издателя код издателя должен вызвать API плана изменений или API изменения количества или обоих.
  2. Корпорация Майкрософт применяет изменение к подписке, а затем уведомляет издателя через веб-перехватчик подключения , чтобы применить то же изменение.
  3. Только после этого издатель должен внести необходимые изменения в подписку SaaS и уведомить Корпорацию Майкрософт об изменении, вызвав обновление состояния API операций.

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

диаграмме с вызовами A P для инициированного издателем обновления.

Уведомление, указывающее на изменение плана, отправляется как покупателю, так и владельцу учетной записи выставления счетов.

Уведомление, указывающее на изменение количества, отправляется как покупателю, так и владельцу учетной записи выставления счетов.

Приостановлено (приостановлено)

Это состояние указывает, что плата клиента за службу SaaS не была получена. Корпорация Майкрософт уведомляет издателя об этом изменении в состоянии подписки SaaS. Уведомление выполняется с помощью вызова веб-перехватчика с параметром для параметра Приостановлено.

Издатель может или не вносить изменения в службу SaaS на стороне издателя. Мы рекомендуем издателю предоставить эти сведения приостановленным клиентам и ограничениям или заблокировать доступ клиента к службе SaaS. Существует вероятность того, что платеж никогда не получен.

Заметка

Корпорация Майкрософт предоставляет клиенту 30-дневный льготный период, прежде чем автоматически отменить подписку. После завершения 30-дневного льготного периода веб-перехватчик получает Unsubscribe действие.

Если подписка находится в состоянии приостановки :

  • Партнер или ISV должны хранить учетную запись SaaS в состоянии восстановления, чтобы полная функциональность была восстановлена без потери данных или параметров.
  • Партнер или isV должен ожидать, что запрос на восстановление подписки, если платеж получен в течение льготного периода, или запрос на отмену подготовки подписки в конце льготного периода. Механизм веб-перехватчика отправляет оба запроса.

Состояние подписки изменяется на Приостановлено на стороне Майкрософт, прежде чем издатель примет любое действие. Можно приостановить только активные подписки.

Уведомление, указывающее на изменение состояния на Приостановленные отправляется как покупателю, так и владельцу учетной записи выставления счетов.

После 30-дневного периода приостановки сообщение электронной почты о отмене после приостановки отправляется как покупателю, так и владельцу учетной записи выставления счетов.

Восстановлено (приостановлено)

Это действие указывает, что инструмент оплаты клиента действителен снова. Оплата была выполнена для подписки SaaS, а подписка восстановлена. В этом случае:

  1. Корпорация Майкрософт вызывает веб-перехватчик с действием параметром Восстановленное значение.
  2. Издатель гарантирует, что подписка полностью работает на стороне издателя.
  3. Процесс восстановления выполнен успешно, и клиент снова оплачивается для подписки SaaS.

Можно восстановить только приостановленную подписку. Приостановленная подписка SaaS остается в состоянии приостановки во время восстановления. После завершения этой операции состояние подписки становится активной.

Сообщение электронной почты отправляется как покупателю, так и владельцу выставления счетов после перехода с приостановленного состояния на восстановленное состояние.

Продлено (подписка)

Корпорация Майкрософт автоматически продлевает подписку SaaS в конце срока подписки месяца или года. Значение по умолчанию для параметра autorenewal true для всех подписок SaaS. Активные подписки SaaS продолжают обновляться с регулярной частотой. Корпорация Майкрософт предоставляет уведомления веб-перехватчика только для обновления. Клиент может отключить автоматическое продление подписки SaaS с помощью портала администрирования Microsoft 365. В этом случае подписка SaaS автоматически отменяется в конце текущего срока выставления счетов. Клиенты также могут отменить подписку SaaS в любое время.

Автоматически обновляются только активные подписки. Подписки остаются активными во время процесса продления и при успешном выполнении автоматического продления. После продления сроки начала и окончания срока подписки обновляются до дат нового срока.

Если автоматическое обновление завершается сбоем из-за проблемы с оплатой, подписка становится приостановленной и издатель уведомляется.

Сообщения электронной почты напоминания о продлении отправляются как покупателю, так и владельцу учетной записи выставления счетов, 30 дней до даты ежегодного или многолетнего продления.

Отменено (отмена подписки)

Подписки достигают этого состояния после того, как выполняется явное действие клиента или CSP, чтобы отменить подписку. Они отменяют подписку с сайта издателя, портала Azure или Центра администрирования Microsoft 365. Подписка также отменяется неявно, в результате неоплачиваемых выплат и после того, как она находится в состоянии приостановки в течение 30 дней.

После того как издатель получит вызов веб-перехватчика отмены, он должен хранить данные клиента для восстановления по запросу не менее семи дней. Только после этого данные клиента можно удалить.

Подписка SaaS может быть отменена в любой момент своего жизненного цикла. После отмены подписки его невозможно повторно активировать.

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

Учебники видео