SaaS-fulfillment-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 kanalen met commerce: direct, partner-led (reseller) en veldgeleid. Integratie met deze API's is een vereiste voor het maken en publiceren van een transactable SaaS-aanbieding in Partnercentrum.
Voor meer informatie over de SaaS-fulfillment-API's raden we u ook aan de volgende artikelen te lezen:
- De levenscyclus van het SaaS-abonnement beheren
- SaaS-uitvoeringsabonnement-API's v2
- SaaS-uitvoeringsbewerkings-API's v2
- Een webhook implementeren in de SaaS-service
- Veelgestelde 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 voor zowel ISV's als Microsoft te behouden:
- Landingspaginastroom: Microsoft meldt de uitgever dat de SaaS-aanbieding van de uitgever is gekocht door een klant in de marketplace.
- Activeringsstroom: Publisher meldt Microsoft dat een nieuw gekocht SaaS-account is geconfigureerd aan de zijde van de uitgever.
- Updatestroom: Wijziging van gekocht abonnement of het aantal aangeschafte seats of beide.
- Stroom onderbreken en opnieuw voltooien: de aangeschafte SaaS-aanbieding onderbreken voor het geval de betalingswijze van de klant niet meer geldig is. De opgeschorte aanbieding kan opnieuw worden ingesteld wanneer het probleem met de betalingswijze wordt opgelost.
- Webhookstromen: Microsoft meldt de uitgever over wijzigingen in SaaS-abonnementen en annuleringen die door de klant van de Microsoft-zijde worden geactiveerd.
Voor de annulering van het aangeschafte SaaS-abonnement is integratie optioneel, omdat deze kan worden uitgevoerd door de klant van Microsoft.
De juiste integratie met SaaS Fulfillment-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 aankoop van gebruikerservaringen, 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 kanalen waarvoor commerce is ingeschakeld:
- Direct
- Door partners geleid (reseller, Cloud Solution Provider [CSP])
- Veldgeleid
In het scenario van de reseller (CSP) koopt een CSP de SaaS-aanbieding namens de eindklant. Er wordt verwacht dat een klant de SaaS-aanbieding gebruikt, maar de CSP is de entiteit die de volgende taken uitvoert:
- Factureert de klant
- Abonnementsabonnementen/aantal aangeschafte seats wijzigen
- De abonnementen worden geannuleerd
Publisher is niet vereist om een van de API-aanroepstromen anders te implementeren voor dit scenario.
Zie Cloud Solution Provider (CSP) voor meer informatie.
Waarschuwing
SaaS Fulfillment-API's versie 1 is afgeschaft; Gebruik in plaats daarvan V2. V1 wordt momenteel alleen onderhouden om bestaande uitgevers te bedienen en documentatie voor V1 is niet meer beschikbaar. Als u denkt dat u er toegang toe nodig hebt, kunt u een e-mail sturen saas-api-v1@microsoft.com.
Notitie
De SaaS-fulfillment-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 service-naar-service-verificatiestroom moet worden gebruikt.
Gerelateerde inhoud
- Als u dit nog niet hebt gedaan, registreert u uw SaaS-toepassing in Azure Portal , zoals wordt uitgelegd in Een Microsoft Entra-toepassing registreren. Gebruik daarna de meest recente versie van deze interface voor ontwikkeling: SaaS-fulfillment subscription-API's v2 en SaaS-fulfillment operations-API's v2.
Videozelfstudies