Achats dans l'application

Microsoft Teams fournit des API que vous pouvez utiliser pour implémenter les achats in-app afin de passer de la version gratuite à la version payante Teams applications. L’achat dans l’application vous permet de convertir des utilisateurs de plans gratuits en plans payants directement à partir de votre application.

Les achats dans l’application permettent aux utilisateurs d’acheter un nouvel abonnement payant et ne permettent pas aux utilisateurs d’acheter des licences supplémentaires ou différentes avec des abonnements payants existants. Pour basculer entre les plans, un abonnement utilisateur existant doit être annulé avant qu’un nouvel abonnement puisse être acheté via des achats dans l’application.

Notes

Les achats dans l’application sont pris en charge uniquement dans les contextes d’application personnels.

Implémenter des achats dans l’application

Pour proposer une expérience d’achat in-app aux utilisateurs de votre application, assurez-vous que :

• L’application est générée avec la bibliothèque de client JavaScript Microsoft Teams (TeamsJS).

• L’application est activée avec une offre SaaS négociable.

• L’application est activée avec les autorisations RSC.

• L’application est invoquée avec l’APIopenPurchaseExperience.

L’expérience d’achat dans l’application peut être activée soit en mettant à jour le fichier manifest.json, soit en activant afficher les offres d’achat dans l’application à partir de la section Autorisations de votre portail du développeur.

Mise à jour du manifeste

Pour activer l’expérience d’achat dans l’application, mettez à jour Teams fichier manifest.json de l’application en ajoutant les autorisations RSC. Il permet aux utilisateurs de votre application de passer à une version payante de votre application et de commencer à utiliser de nouvelles fonctionnalités. La mise à jour du manifeste de l’application est la suivante :

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

API Expérience d’achat

Pour déclencher l'achat in-app pour l'application, invoquez openPurchaseExperiencel'API depuis votre application web.

L’extrait de code suivant est un exemple d’appel de l’API à partir de l’application Teams créée à l’aide de la bibliothèque de client JavaScript Microsoft Teams :

TeamsJS v1

<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>

TeamsJS v2

<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>

Étape suivante

Aperçu du test pour les applications monétisées