Skip to content

tovmy/office-add-in-saas-monetization-sample

 
 

Repository files navigation

page_type products languages extensions description
sample
office-outlook
office-365
office-sp
javascript
contentType technologies createdDate
samples
Add-ins
2/14/2020 12:00:00 PM
Learn how to create a simple license management system to manage add-ins sold in Microsoft AppSource

Introduction

This code sample demonstrates how Microsoft ISVs can create a simple license management system to manage add-ins sold in Microsoft AppSource. This code sample package includes a Microsoft AppSource mock web app, a SaaS sample, a SharePoint add-in, an Outlook add-in, and a licensing management tool.

Installation and Configuration

Follow the instructions in the deployment guides to install and configure the sample.

  1. Sample Deployment Guide
  2. SPFx add-in Deployment Guide
  3. Outlook add-in Deployment Guide

Testing

Follow the instructions in the test guide to test the different use cases.

  1. Test Guide

Inventory

This section links to the various README files associated with the projects included in the sample. Read the README files for more information about each project.

Appendix

UX / API Mapping

This matrix describes the user interface actions and how they correlate to different API calls.

User interface where the API is invoked API Call Mock API Exists Mock API Works Can we test the Mock API without the offer being published to the public? Can we test the Production API without the offer being published to the public?
Resolve a subscription in purchase process:

HttpPost
https://marketplaceapi.microsoft.com/api/saas/subscriptions/resolve?api-version=2018-09-15
Yes Yes Yes No
Activate a subscription in purchase process:

HttpPost
https://marketplaceapi.microsoft.com/api/saas/subscriptions/0aa95e32-8be7-4e5e-94f9-563f6d7d9dcd/activate?api-version=2018-09-15
Yes Yes Yes No
Update the quantity on the subscription in plan/quantity changed process

HttpPatch
https://marketplaceapi.microsoft.com/api/saas/subscriptions/0aa95e32-8be7-4e5e-94f9-563f6d7d9dcd?api-version=2018-09-15

Note: Although the patch request works, but actually the test data will not be updated, and the web hook will not be triggered as well.
Yes Yes No No
Update the status of an operation in plan/quantity changed process

HttpPatch
https://marketplaceapi.microsoft.com/api/saas/subscriptions/0aa95e32-8be7-4e5e-94f9-563f6d7d9dcd/operations/7688ae05-1579-4fdd-be89-12b45f0a4ef3?api-version=2018-09-15
Yes Yes No No
Query operations in plan/quantity changed process

HttpPatch
https://marketplaceapi.microsoft.com/api/saas/subscriptions/0aa95e32-8be7-4e5e-94f9-563f6d7d9dcd/operations?api-version=2018-09-15
Yes Yes Yes No
Webhook on the SaaS service No No No No

Copyright

Copyright (c) 2020 Microsoft Corporation. All rights reserved.

About

Monetize your Office 365 add-in through Microsoft Commercial Marketplace

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 98.8%
  • Other 1.2%