Hantera SaaS-prenumerationens livscykel
Den kommersiella marknadsplatsen hanterar hela livscykeln för en SaaS-prenumeration efter slutanvändarens köp. Den använder landningssidan, API:er för uppfyllelse, drift-API:er och webhooken som en mekanism för att driva den faktiska SaaS-prenumerationsaktiveringen, användningen, uppdateringarna och annulleringen. Slutanvändarens faktura baseras på tillståndet för den SaaS-prenumeration som Microsoft underhåller.
Tillstånd för en SaaS-prenumeration
Följande diagram visar tillstånden för en SaaS-prenumeration och tillämpliga åtgärder.
Köpt men ännu inte aktiverat (PendingFulfillmentStart)
När en slutanvändare eller molnlösningsleverantör (CSP) har köpt ett SaaS-erbjudande på den kommersiella marknadsplatsen meddelas utgivaren om köpet. Utgivaren kan sedan skapa och konfigurera ett nytt SaaS-konto på utgivarsidan för slutanvändaren.
Så här skapar du ett konto:
- Kunden väljer knappen Konfigurera konto nu som är tillgängligt för ett SaaS-erbjudande efter det lyckade köpet i Microsoft AppSource eller Azure-portalen. Alternativt kan kunden använda knappen Konfigurera nu i e-postmeddelandet som de får strax efter köpet.
- Microsoft meddelar sedan partnern om köpet genom att öppna landningssidans URL med tokenparametern (inköpsidentifieringstoken från den kommersiella marknadsplatsen) på den nya webbläsarfliken.
Ett exempel på ett sådant anrop är https://contoso.com/signup?token=<blob>, men målsidans URL för det här SaaS-erbjudandet i Partnercenter har konfigurerats som https://contoso.com/signup. Den här token ger utgivaren ett ID som unikt identifierar SaaS-köpet och kunden.
Dricks
Ta inte med tecknet för pund (#) i målsidans URL. Annars kommer kunderna inte att kunna komma åt din landningssida.
Viktigt!
Målsidans URL måste vara igång hela dagen, varje dag och redo att ta emot nya samtal från Microsoft hela tiden. Om landningssidan blir otillgänglig kan kunderna inte registrera sig för SaaS-tjänsten och börja använda den.
Därefter måste utgivaren skicka tillbaka token till Microsoft genom att anropa SaaS Resolve API och ange token som värdet för parametern x-ms-marketplace-token header . Som ett resultat av anropet för Lös API byts token ut för information om SaaS-köpet, till exempel det unika ID:t för köpet, köpt erbjudande-ID och köpt abonnemangs-ID.
På landningssidan ska kunden loggas in på det nya eller befintliga SaaS-kontot via enkel inloggning med Microsoft Entra (SSO).
Kommentar
Utgivaren meddelas inte om SaaS-köpet förrän kunden initierar konfigurationsprocessen från Microsoft-sidan.
Utgivaren bör implementera enkel inloggning för att tillhandahålla den användarupplevelse som krävs av Microsoft för det här flödet. Se till att använda Microsoft Entra-programmet med flera klientorganisationer och tillåt både arbets- och skolkonton eller personliga Microsoft-konton när du konfigurerar enkel inloggning. Det här kravet gäller endast för landningssidan för användare som omdirigeras till SaaS-tjänsten när de redan är inloggade med Microsoft-autentiseringsuppgifter. Enkel inloggning krävs inte för alla inloggningar till SaaS-tjänsten.
Kommentar
Om enkel inloggning kräver att en administratör beviljar behörighet till en app måste beskrivningen av erbjudandet i Partnercenter avslöja att åtkomst på administratörsnivå krävs. Det här avslöjandet ska följa certifieringsprinciperna för den kommersiella marknadsplatsen.
Efter inloggningen bör kunden slutföra SaaS-konfigurationen på utgivarsidan. Utgivaren måste sedan anropa API:et Aktivera prenumeration för att skicka en signal till Azure Marketplace om att etableringen av SaaS-kontot är klar. Den här åtgärden startar kundens faktureringsperiod. Om API-anropet aktivera prenumeration inte lyckas debiteras inte kunden för köpet.
Både köparen och faktureringskontots ägare får ett e-postmeddelande där de uppmanas att konfigurera kontot.
Kommentar
Utgivaren har 30 dagar på sig att lösa tillgången när statusen är PendingFulfillmentStart, annars kommer tillgången att ogiltigförklaras eftersom faktureringscykeln inte initierades och respektive köp inte faktureras. Statusen ändras till Avbryt prenumeration. Kunden debiteras inte för köpet.
Aktiv (prenumererad)
Aktiv (prenumererad) är det stadiga tillståndet för en etablerad SaaS-prenumeration. När Microsoft-sidan har bearbetat API-anropet Aktivera prenumeration markeras SaaS-prenumerationen som Prenumererad. Kunden kan nu använda SaaS-tjänsten på utgivarens sida och debiteras.
När en SaaS-prenumeration redan är aktiv kan kunden välja Hantera SaaS-upplevelse från Azure-portalen eller Administrationscenter för Microsoft 365. Den här åtgärden gör också att Microsoft anropar landningssidans URL med tokenparametern , vilket händer i flödet Aktivera. Utgivaren bör skilja mellan nya inköp och hanteringen av befintliga SaaS-konton och hantera det här url-anropet för landningssidan i enlighet med detta.
Ett e-postmeddelande om aktivering skickas till både köparen och faktureringskontots ägare.
Uppdateras (prenumererar)
Den här åtgärden innebär att en uppdatering av en befintlig aktiv SaaS-prenumeration bearbetas av både Microsoft och utgivaren. En sådan uppdatering kan initieras av:
- Kunden från den kommersiella marknadsplatsen.
- CSP:en från den kommersiella marknadsplatsen.
- Kunden från utgivarens SaaS-webbplats (men inte för CSP-gjorda inköp).
Två typer av uppdateringar är tillgängliga för en SaaS-prenumeration:
- Uppdatera planen när kunden väljer en annan plan för prenumerationen.
- Uppdatera kvantiteten när kunden ändrar antalet köpta licenser för prenumerationen.
Endast en aktiv prenumeration kan uppdateras. Medan prenumerationen uppdateras förblir dess tillstånd Aktivt på Microsoft-sidan.
Uppdatering initierad från den kommersiella marknadsplatsen
I det här flödet ändrar kunden prenumerationsplanen eller antalet licenser från Azure-portalen eller Administrationscenter för Microsoft 365.
- När en uppdatering har angetts anropar Microsoft utgivarens webhook-URL, konfigurerad i fältet Anslut ion webhook på sidan Teknisk konfiguration i Partnercenter, med ett lämpligt värde för åtgärd och andra relevanta parametrar.
- Utgivarsidan bör göra nödvändiga ändringar i SaaS-tjänsten och meddela Microsoft när det är klart genom att anropa API:ets uppdateringsstatus.
- Om korrigeringen skickas med felstatus slutförs inte uppdateringsprocessen på Microsoft-sidan. SaaS-prenumerationen behåller den befintliga planen och mängden licenser.
Kommentar
Utgivaren bör anropa PATCH för att uppdatera statusen för åtgärds-API :et med ett fel-/lyckat svar inom 10 sekunder efter att webhook-meddelandet har tagits emot. Om PATCH för åtgärdsstatus inte tas emot inom 10 sekunder korrigeras ändringsplanen automatiskt som Lyckad.
Sekvensen med API-anrop för ett uppdateringsscenario som initieras från den kommersiella marknadsplatsen visas i följande diagram.
Uppdatering initierad från utgivaren
I det här flödet ändrar kunden prenumerationsplanen eller antalet licenser som köpts från Själva SaaS-tjänsten.
Innan du gör den begärda ändringen på utgivarsidan måste utgivarkoden anropa API:et för ändringsplan eller API:et för ändringsk kvantitet eller båda.
Microsoft tillämpar ändringen på prenumerationen och meddelar sedan utgivaren via Anslut ion webhook att tillämpa samma ändring.
Först då bör utgivaren göra den nödvändiga ändringen av SaaS-prenumerationen och meddela Microsoft när ändringen görs genom att anropa Uppdateringsstatus för åtgärds-API.
Sekvensen med API-anrop för ett uppdateringsscenario som initieras från utgivarsidan visas i följande diagram.
Ett e-postmeddelande som anger en planändring skickas till både köparen och faktureringskontots ägare.
Ett e-postmeddelande som anger en ändring i kvantitet skickas till både köparen och faktureringskontots ägare.
Pausad (pausad)
Det här tillståndet anger att en kunds betalning för SaaS-tjänsten inte togs emot. Microsoft meddelar utgivaren om den här ändringen i SaaS-prenumerationsstatusen. Meddelandet görs via ett anrop till webhook med åtgärdsparametern inställd på Pausad.
Utgivaren kanske eller kanske inte gör ändringar i SaaS-tjänsten på utgivarsidan. Vi rekommenderar att utgivaren gör den här informationen tillgänglig för den avstängda kunden och begränsar eller blockerar kundens åtkomst till SaaS-tjänsten. Det finns en sannolikhet att betalningen aldrig tas emot.
Kommentar
Microsoft ger kunden en respitperiod på 30 dagar innan prenumerationen avbryts automatiskt. När respitperioden på 30 dagar är över får webhooken en Unsubscribe åtgärd.
När en prenumeration är i inaktiverat tillstånd:
- Partnern eller ISV:n måste ha SaaS-kontot i ett återställningsbart tillstånd, så att fullständiga funktioner kan återställas utan att data eller inställningar går förlorade.
- Partnern eller ISV:n bör förvänta sig en begäran om att återställa prenumerationen, om betalningen tas emot under respitperioden eller en begäran om att avetablera prenumerationen i slutet av respitperioden. Båda begäranden skickas via webhook-mekanismen.
Prenumerationstillståndet ändras till Pausad på Microsoft-sidan innan utgivaren vidtar någon åtgärd. Endast aktiva prenumerationer kan pausas.
Ett e-postmeddelande som anger statusändringen till "pausad" skickas till både köparen och faktureringskontots ägare.
Efter en 30-dagars avstängningsperiod skickas ett e-postmeddelande om annulleringen efter avstängningen till både köparen och faktureringskontots ägare.
Återställd (pausad)
Den här åtgärden anger att kundens betalningsmedel har blivit giltigt igen, att en betalning har gjorts för SaaS-prenumerationen och att prenumerationen återställs. I det här fallet:
- Microsoft anropar webhook med en åtgärdsparameter inställd på värdet Återställ.
- Utgivaren ser till att prenumerationen fungerar fullt ut igen på utgivarsidan.
- Återställningsprocessen lyckas och kunden debiteras igen för SaaS-prenumerationen.
Endast en pausad prenumeration kan återställas. Den inaktiverade SaaS-prenumerationen förblir i ett inaktiverat tillstånd medan den återställs. När den här åtgärden är klar blir prenumerationens status aktiv.
Ett e-postmeddelande skickas till både köparen och faktureringsägaren efter övergången från pausat tillstånd till återställt tillstånd.
Förnyad (prenumererad)
SaaS-prenumerationen förnyas automatiskt av Microsoft i slutet av prenumerationsperioden på en månad eller ett år. Standardinställningen för automatisk förnyelse gäller för alla SaaS-prenumerationer. Aktiva SaaS-prenumerationer fortsätter att förnyas med en regelbunden takt. Microsoft tillhandahåller webhooksaviseringar endast för att förnya händelser. En kund kan inaktivera automatisk förnyelse för en SaaS-prenumeration via Microsoft 365-administratörsportalen. I det här fallet avbryts SaaS-prenumerationen automatiskt i slutet av den aktuella faktureringsperioden. Kunder kan också avbryta SaaS-prenumerationen när som helst.
Endast aktiva prenumerationer förnyas automatiskt. Prenumerationer förblir aktiva under förnyelseprocessen och om automatisk förnyelse lyckas. Efter förnyelsen uppdateras start- och slutdatumen för prenumerationsperioden till den nya periodens datum.
Om en automatisk förnyelse misslyckas på grund av ett betalningsproblem kommer prenumerationen att inaktiveras och utgivaren meddelas.
Påminnelsemeddelanden om förnyelse skickas till både köparen och ägaren av faktureringskontot, 30 dagar före förnyelsedatumet för år/år.
Avbruten (avprenumererad)
Prenumerationer når det här tillståndet som svar på en explicit kund- eller CSP-åtgärd genom att avbryta en prenumeration från utgivarens webbplats, Azure-portalen eller Administrationscenter för Microsoft 365. En prenumeration kan också avbrytas implicit, till följd av utebliven betalning av avgifter, efter att ha varit i tillståndet Pausad i 30 dagar.
När utgivaren har fått ett webhook-anrop för annullering bör de behålla kunddata för återställning vid begäran i minst sju dagar. Endast då kan kunddata tas bort.
En SaaS-prenumeration kan avbrytas när som helst i livscykeln. När en prenumeration har avbrutits kan den inte återaktiveras.
E-postmeddelande om annullering skickas till både köparen och ägaren av faktureringskontot.
Nästa steg
Videovägledningar
Feedback
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i: https://aka.ms/ContentUserFeedback.
Skicka och visa feedback för