Настройка покупок из приложения

Покупки из приложения — это варианты обновления, при которых пользователи могут переходить с бесплатного на платные планы в приложении. Microsoft Teams предоставляет API для реализации покупок из приложения. Вариант покупки из приложения применим только в том случае, если приложение включено с предложением SaaS с транзакцией.

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

Примечание.

Покупки из приложения поддерживаются только в личных контекстах приложений.

Реализация покупок в приложении

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

• Приложение создается с помощью клиентской библиотеки JavaScript (TeamsJS) Microsoft Teams.

• Приложение включается с предложением SaaS для транзакций.

• Приложение включается с разрешениями RSC.

• Приложение вызывается с помощью openPurchaseExperience API.

Активация покупки из приложения

Вы можете активировать интерфейс покупки из приложения одним из следующих способов:

Обновление с портала разработчика

1. На портале разработчика Teams перейдите в раздел Разрешения.
2. Включите параметр Show in-app purchase offers (Показывать предложения покупки из приложения).

Изменение манифеста

Чтобы включить интерфейс покупки из приложения, обновите файл приложения manifest.json Teams, добавив разрешения RSC. Это позволяет пользователям приложения перейти на платную версию приложения и получить доступ к новым функциям. Обновите манифест приложения, как указано в следующем фрагменте кода:

    
    "authorization": {
        "permissions": {
            "resourceSpecific": [
                {
                    "name": "InAppPurchase.Allow.User",
                    "type": "Delegated"
                }
            ]
        }
    }

API покупки

Чтобы инициировать покупку в приложении для вашего веб-приложения, вызовите из него openPurchaseExperienceAPI. Следующий фрагмент кода является примером вызова API из приложения Teams, созданного с помощью TeamsJS:

TeamsJS версии 2

<div>
<div class="sectionTitle">openPurchaseExperience</div>
<button onclick="openPurchaseExperience()">openPurchaseExperience</button>
</div>
</body>
<script>
    function openPurchaseExperience() {
      micorosftTeams.app.initialize();
      var planInfo = {
          planId: "<Plan id>", // Plan Id of the published SAAS Offer
          term: "<Plan Term>" // Term of the plan.
      }
      monetization.openPurchaseExperience(planInfo);
    }
</script>

TeamsJS версии 1

<div> 
<div class="sectionTitle">openPurchaseExperience</div>
<button onclick="openPurchaseExperience()">openPurchaseExperience</button>
</div>
</body>
<script>
   function openPurchaseExperience()
      microsoftTeams.initialize();
      let callbackcalled = false;
      microsoftTeams.monetization.openPurchaseExperience((e) => {
            console.log("callback is being called");
            console.log(e);
            if (!!e && typeof e !== "string") {
                  alert(JSON.stringify(e));
              }
              return;
            });
      console.log("after callback: ",callbackcalled);
    }
</script>

См. также

• Монетизация приложения
• Манифест приложения