API:er för uppfyllning av SaaS på Microsofts kommersiella marknadsplats
API:erna för uppfyllning av SaaS gör det möjligt för utgivare, även kallade oberoende programvaruleverantörer (ISV), att publicera och sälja sina SaaS-program i Microsoft AppSource, Azure Marketplace och Azure Portal. Dessa API:er gör det möjligt för ISV-program att delta i alla handelsaktiverade kanaler: direkt, partnerledd (återförsäljare) och fältledd. Integrering med dessa API:er är ett krav för att skapa och publicera ett transakterbart SaaS-erbjudande i Partnercenter.
Om du vill veta mer om API:er för uppfyllande av SaaS rekommenderar vi att du även läser följande artiklar:
- Hantera SaaS-prenumerationens livscykel
- API:er för saaS-uppfyllelseprenumeration v2
- API:er för uppfyllande av SaaS v2
- Implementera en webhook på SaaS-tjänsten
- Vanliga frågor om API:er för uppfyllning av SaaS
API-flöden
ISV:er måste implementera följande API-flöden genom att lägga till i sin SaaS-tjänstkod för att upprätthålla samma prenumerationsstatus för både ISV:er och Microsoft:
- Flöde för landningssida: Microsoft meddelar utgivaren att utgivarens SaaS-erbjudande har köpts av en kund på Marketplace.
- Aktiveringsflöde: Publisher meddelar Microsoft att ett nyligen köpt SaaS-konto har konfigurerats på utgivarens sida.
- Uppdateringsflöde: Ändring av köpt plan eller antalet köpta platser eller både och.
- Pausa och återställa flöde: Pausa det köpta SaaS-erbjudandet om kundens betalningsmetod inte längre är giltig. Det inaktiverade erbjudandet kan återställas när problemet med betalningsmetoden har lösts.
- Webhook-flöden: Microsoft meddelar utgivaren om ändringar i SaaS-prenumerationen och annullering som utlöses av kunden från Microsoft-sidan.
För annullering av den köpta SaaS-prenumerationen är integrering valfritt, eftersom det kan göras av kunden från Microsoft-sidan.
Rätt integrering med API:er för uppfyllelse av SaaS är viktigt för att se till att:
- Slutanvändare som har köpt utgivarens SaaS-erbjudande debiteras korrekt av Microsoft.
- Slutkunder får rätt köpupplevelse, konfigurerar, använder och hanterar SaaS-prenumerationer som köpts på Marketplace.
Dessa API:er gör det möjligt för utgivarens erbjudanden att delta i alla handelsaktiverade kanaler:
- Direct
- Partnerledd (återförsäljare, CSP)
- Fältledd
I scenariot med återförsäljaren (CSP) köper en CSP SaaS-erbjudandet åt slutanvändaren. En kund förväntas använda SaaS-erbjudandet, men CSP är den entitet som utför följande uppgifter:
- Fakturerar kunden
- Ändrar prenumerationsplaner/antal köpta platser
- Avbryter prenumerationerna
Den Publisher krävs inte för att implementera något av API-anropsflödena på olika sätt för det här scenariot.
Mer information om CSP finns i https://partner.microsoft.com/licensing .
Varning
Den aktuella versionen av det här API:et är version 2, som ska användas för alla nya SaaS-erbjudanden. Version 1 av API:et är inaktuell och underhålls för att stödja befintliga erbjudanden.
Anteckning
API:erna för uppfyllning av SaaS är endast avsedda att anropas från en utgivares backend-tjänst. Integrering med API:erna direkt från utgivarens webbsida stöds inte. Endast tjänst-till-tjänst-autentiseringsflöde ska användas.
Nästa steg
- Om du inte redan har gjort det registrerar du SaaS-programmet i Azure Portal beskrivs i Registrera ett Azure AD-program. Använd sedan den senaste versionen av det här gränssnittet för utveckling: API:er för saaS-uppfyllelseprenumeration v2 och API:er för SaaS-uppfyllelseåtgärder v2.