Configurer les achats dans l’application

Les achats dans l’application sont des options de mise à niveau dans lesquelles les utilisateurs peuvent passer de plans gratuits à des plans payants au sein de votre application. Microsoft Teams fournit des API pour implémenter des achats dans l’application. L’option d’achat in-app s’applique uniquement si l’application est activée avec une offre SaaS pouvant faire l’objet de transactions.

Les utilisateurs peuvent acheter de nouveaux abonnements payants par le biais d’achats dans l’application. Toutefois, ils ne peuvent pas acheter de licences supplémentaires ou différentes avec des abonnements payants existants. Pour modifier les plans, les utilisateurs doivent d’abord annuler leur abonnement actuel avant d’acquérir un nouveau plan par le biais d’un achat dans l’application.

Remarque

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

Implémenter des achats dans l’application

Pour faciliter une expérience d’achat dans l’application pour les utilisateurs de votre application, vérifiez que les conditions préalables suivantes sont remplies :

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

• L’application est activée avec une offre SaaS pouvant faire l’objet de transactions.

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

• L’application est appelée avec openPurchaseExperience l’API.

Activer l’achat dans l’application

Vous pouvez activer l’expérience d’achat dans l’application de l’une des manières suivantes :

Mettre à jour à partir du portail des développeurs

1. Dans le portail des développeurs Teams, accédez à Autorisations.
2. Activez Afficher les offres d’achat dans l’application.

Mise à jour du manifeste

Pour activer l’expérience d’achat dans l’application, mettez à jour votre fichier d’application manifest.json Teams en ajoutant les autorisations RSC. Il permet aux utilisateurs de votre application de mettre à niveau vers une version payante de votre application et d’accéder aux nouvelles fonctionnalités. Mettez à jour le manifeste de l’application comme indiqué dans l’extrait de code suivant :

    
    "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 TeamsJS :

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>

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>

Voir aussi

• Monétiser votre application
• Manifeste d'application