Compras desde la aplicación

Microsoft Teams proporciona API que puede usar para implementar las compras desde la aplicación para actualizar las aplicaciones de Teams de gratuitas a pagas. La compra desde la aplicación te permite convertir usuarios de planes gratuitos a de pago directamente desde tu aplicación.

Las compras desde la aplicación permiten a los usuarios comprar una nueva suscripción de pago y no permite a los usuarios comprar licencias adicionales o diferentes con suscripciones de pago existentes. Para cambiar entre planes, se debe cancelar una suscripción de usuario existente antes de que se pueda comprar una nueva suscripción a través de compras desde la aplicación.

Nota:

Las compras desde la aplicación solo se admiten en contextos de aplicaciones personales.

Implementar compras desde la aplicación

Para ofrecer una experiencia de compra desde la aplicación a los usuarios de la aplicación, asegúrese de lo siguiente:

• La aplicación se compila con la biblioteca cliente JavaScript de Microsoft Teams (TeamsJS).

• La aplicación está habilitada con una oferta de SaaS transaccionable.

• La aplicación está habilitada con permisos de RSC.

• La aplicación se invoca con openPurchaseExperience API.

La experiencia de compra desde la aplicación se puede habilitar actualizando el archivo manifest.json o habilitando Mostrar ofertas de compra desde la aplicación desde la sección Permisos de la Portal para desarrolladores.

Actualizar manifiesto

Para habilitar la experiencia de compra desde la aplicación, actualice el archivo manifest.json de la aplicación de Teams agregando los permisos de RSC. Permite a los usuarios de la aplicación actualizar a una versión de pago de la aplicación y empezar a usar nuevas funcionalidades. La actualización del manifiesto de la aplicación es la siguiente:

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

API de experiencia de compra

Para desencadenar la compra desde la aplicación para la aplicación, invoque la API openPurchaseExperience desde la aplicación web.

El siguiente fragmento de código es un ejemplo de llamada a la API desde la aplicación de Teams compilada mediante la biblioteca cliente JavaScript de 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>

Paso siguiente

Versión preliminar de prueba para aplicaciones monetizadas