SaaS-uitvoerings-API's in de commerciële marketplace van Microsoft
Met de SaaS Fulfillment-API's kunnen uitgevers, ook wel onafhankelijke softwareleveranciers (ISV's) genoemd, hun SaaS-toepassingen publiceren en verkopen in Microsoft AppSource, Azure Marketplace en Azure Portal. Met deze API's kunnen ISV-toepassingen deelnemen aan alle commerciële kanalen: direct, partner-led (reseller) en field-led. Integratie met deze API's is een vereiste voor het maken en publiceren van een transactable SaaS-aanbieding in Partner Center.
Voor meer informatie over de SaaS-uitvoerings-API's raden we u aan ook de volgende artikelen te lezen:
- De levenscyclus van het SaaS-abonnement beheren
- Api's voor SaaS-uitvoeringsabonnement v2
- SaaS-uitvoeringsbewerkings-API's v2
- Een webhook implementeren in de SaaS-service
- Veelvoorkomende vragen over SaaS-uitvoerings-API's
API-stromen
ISV's moeten de volgende API-stromen implementeren door toe te voegen aan hun SaaS-servicecode om dezelfde abonnementsstatus te behouden voor zowel ISV's als Microsoft:
- Stroom voor landingspagina: Microsoft meldt de uitgever dat de SaaS-aanbieding van de uitgever is gekocht door een klant in de marketplace.
- Activeringsstroom: Publisher Microsoft een bericht dat een nieuw gekocht SaaS-account is geconfigureerd aan de zijde van de uitgever.
- Stroom bijwerken: Wijziging van het aangeschafte abonnement of het aantal aangeschafte seats of beide.
- Stroom opschorten en opnieuw in gang maken: De aangeschafte SaaS-aanbieding wordt tijdelijk opgeschort voor het geval de betalingswijze van de klant niet meer geldig is. De aanbieding die is opgeschort, kan opnieuw worden ingesteld wanneer het probleem met de betalingswijze is opgelost.
- Webhookstromen: Microsoft informeert de uitgever over wijzigingen en annuleringen van SaaS-abonnementen die door de klant zijn geactiveerd vanuit Microsoft.
Voor het annuleren van het aangeschafte SaaS-abonnement is integratie optioneel, omdat dit door de klant van Microsoft kan worden gedaan.
Juiste integratie met SaaS-uitvoerings-API's is essentieel om ervoor te zorgen dat:
- Eindklanten die de SaaS-aanbieding van de uitgever hebben gekocht, worden correct gefactureerd door Microsoft.
- Eindgebruikers krijgen de juiste gebruikerservaring bij het kopen, configureren, gebruiken en beheren van SaaS-abonnementen die zijn aangeschaft in de marketplace.
Met deze API's kunnen de aanbiedingen van de uitgever deelnemen aan alle commerce-kanalen:
- Direct
- Door partner geleid (reseller, CSP)
- Veld-led
In het scenario van de reseller (CSP) koopt een CSP de SaaS-aanbieding namens de eindklant. Van een klant wordt verwacht dat deze de SaaS-aanbieding gebruikt, maar de CSP is de entiteit die de volgende taken uitvoert:
- De klant in rekening worden gefacturen
- Abonnementsabonnementen/aantal aangeschafte seats wijzigen
- Annuleert de abonnementen
De Publisher is niet vereist om een van de API-aanroepstromen anders te implementeren voor dit scenario.
Raadpleeg voor meer informatie over https://partner.microsoft.com/licensing CSP.
Waarschuwing
De huidige versie van deze API is versie 2, die moet worden gebruikt voor alle nieuwe SaaS-aanbiedingen. Versie 1 van de API is afgeschaft en wordt onderhouden ter ondersteuning van bestaande aanbiedingen.
Notitie
De SaaS-uitvoerings-API's zijn alleen bedoeld om te worden aangeroepen vanuit een back-endservice van de uitgever. Integratie met de API's rechtstreeks vanaf de webpagina van de uitgever wordt niet ondersteund. Alleen de service-naar-service-verificatiestroom mag worden gebruikt.
Volgende stappen
- Als u dit nog niet hebt gedaan, registreert u uw SaaS-toepassing in de Azure Portal zoals uitgelegd in Een Azure AD-toepassing registreren. Gebruik daarna de meest recente versie van deze interface voor ontwikkeling: Api's voor SaaS-uitvoeringsabonnement v2 en SaaS-uitvoeringsbewerkings-API's v2.