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
- Api's voor SaaS-uitvoeringsabonnement v2
- SaaS-uitvoerings-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 aan de zijde van de uitgever is geconfigureerd.
- Bijwerkstroom: Wijziging van het gekochte abonnement of het aantal aangeschafte plaatsen of beide.
- Proces onderbreken en hervatten: De onderbreking van het aangekochte SaaS-aanbod in het geval dat de betalingsmethode van de klant niet meer geldig is. De opgeschorte aanbieding kan opnieuw worden ingesteld wanneer het probleem met de betalingswijze wordt opgelost.
- Webhook-stromen: Microsoft meldt de uitgever over wijzigingen in SaaS-abonnementen en annuleringen die door de klant aan 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 gebruikerservaring bij het aanschaffen, configureren, gebruiken en beheren van SaaS-abonnementen die op de marktplaats zijn gekocht.
Met deze API's kunnen de aanbiedingen van de uitgever deelnemen aan alle kanalen waarvoor commerce is ingeschakeld:
- Rechtstreeks
- Partnergestuurd (reseller, Cloud Solution Provider [CSP])
- Veldgeleide
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
- Abonnementen/aantal aangeschafte plaatsen wijzigen
- De abonnementen worden geannuleerd
De Publisher hoeft geen van de API-aanroepstromen anders te implementeren voor dit scenario.
Zie CSP-(Cloud Solution Provider) voor meer informatie.
Belangrijk
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 e-mailen 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 de service-naar-service-verificatiestroom mag worden gebruikt.
Verwante inhoud
- Als u dit nog niet hebt gedaan, registreert u uw SaaS-toepassing in de Azure Portal zoals uitgelegd in Een Microsoft Entra-toepassing registreren.
- Gebruik daarna de meest recente versie van deze interface voor ontwikkeling: SaaS-fulfillmentabonnementen-API's v2 en SaaS-fulfillmentoperatie-API's v2.
videohandleidingen