Dela via

Hantera SaaS-prenumerationens livscykel

  • Artikel

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.

Diagram som visar livscykeln för programvara som en tjänstprenumeration på Marketplace.

Köpt men inte aktiverat än (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:

  1. Kunden väljer Konfigurera konto nu-knappen som är tillgänglig 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.
  2. 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 kan kunderna inte komma åt din landningssida. Utgivaren har 30 dagar på sig att lösa tillgången när statusen är PendingFulfillmentStart. Annars ogiltigförklaras tillgången. Eftersom faktureringscykeln inte initierades och respektive köp inte faktureras ändras statusen till Avsluta prenumerationen. Kunden debiteras inte för köpet.

Viktig

Målsidans URL måste vara igång hela dagen, varje dag och redo att ta emot nya samtal från Microsoft alltid. 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 token tillbaka till Microsoft genom att anropa SaaS Resolve APIoch 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).

Not

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.

Not

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 certifieringsprinciper 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.

diagram som visar A P I-anrop för ett etableringsscenario.

Både köparen och faktureringskontots ägare får ett e-postmeddelande där de uppmanas att konfigurera kontot.

Not

Utgivaren har 30 dagar på sig att lösa tillgången när statusen är PendingFulfillmentStart. Annars ogiltigförklaras tillgången eftersom faktureringscykeln inte initierades och respektive köp inte faktureras. Statusen ändras till Avprenumererad. Kunden debiteras inte för köpet.

Active (Prenumererar)

Aktiv (prenumererad) är det stadiga tillståndet för en etablerad SaaS-prenumeration. När Microsoft-sidan har bearbetats Aktivera prenumerations-API:et anropet 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 url:en för landningssida med parametern token, 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. Uppdateringar 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.

  1. När en uppdatering har angetts anropar Microsoft utgivarens webhook-URL, som konfigurerats i Connection webhook-fältet på sidan Teknisk konfiguration i Partnercenter, med ett lämpligt värde för åtgärd och andra relevanta parametrar.
  2. Utgivarsidan bör göra nödvändiga ändringar i SaaS-tjänsten och meddela Microsoft när det är klart genom att anropa Uppdateringsstatus för åtgärds-API:et.
  3. Om korrigeringen skickas med misslyckas status slutförs inte uppdateringsprocessen på Microsoft-sidan. SaaS-prenumerationen behåller den befintliga planen och mängden licenser.

Not

Utgivaren bör anropa PATCH för att uppdatera status för åtgärds-API:et med ett fel-/lyckat svar inom ett 10-sekunders tidsfönster när webhook-meddelandet har tagits emot. Om PATCH för åtgärdsstatus inte tas emot inom 10 sekunder korrigeras ändringsplanen automatiskt som Lyckades.

Sekvensen med API-anrop för ett uppdateringsscenario som initieras från den kommersiella marknadsplatsen visas i följande diagram.

diagram som visar A P I-anrop för en marketplace-initierad uppdatering.

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.

  1. Innan den begärda ändringen görs på utgivarsidan måste utgivarkoden anropa API:et för ändringsplan eller API för ändringskvantitet eller båda.
  2. Microsoft tillämpar ändringen på prenumerationen och meddelar sedan utgivaren via Connection webhook att tillämpa samma ändring.
  3. 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:et.

Sekvensen med API-anrop för ett uppdateringsscenario som initieras från utgivarsidan visas i följande diagram.

diagram som visar A P I-anrop för en initierad uppdatering på utgivarsidan.

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 av den här ändringen i SaaS-prenumerationsstatusen. Meddelandet görs via ett anrop till webhooken med parametern 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.

Not

Microsoft ger kunden en respitperiod på 30 dagar innan prenumerationen avbryts automatiskt. När respitperioden på 30 dagar är över tar webhooken emot en Unsubscribe åtgärd.

När en prenumeration är i tillståndet Pausad:

  • 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. Webhook-mekanismen skickar båda begäranden.

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 ändringen i status 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 är giltigt igen. En betalning gjordes för SaaS-prenumerationen och prenumerationen återställs. I det här fallet:

  1. Microsoft anropar webhook med en åtgärd parameter inställd på värdet Återställd.
  2. Utgivaren ser till att prenumerationen fungerar fullt ut igen på utgivarsidan.
  3. Återställningsprocessen lyckas och kunden debiteras igen för SaaS-prenumerationen.

Endast en pausad prenumeration kan återställas. Den inaktiverade SaaS-prenumerationen är fortfarande i ett pausat 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 (prenumererar)

Microsoft förnyar automatiskt SaaS-prenumerationen i slutet av prenumerationsperioden på en månad eller ett år. Standardinställningen för autorenewal är sant 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 ett autorenewal misslyckas på grund av ett betalningsproblem blir prenumerationen Pausad och utgivaren meddelas.

E-postpåminnelser för förnyelse skickas till både köparen och ägaren av faktureringskontot, 30 dagar före förnyelsedatumet för år/år.

Avbröts (avregistrerade)

Prenumerationer når det här tillståndet när en explicit kund- eller CSP-åtgärd vidtas för att avbryta prenumerationen. De avbryter en prenumeration från utgivarens webbplats, Azure-portalen eller Administrationscenter för Microsoft 365. En prenumeration avbryts också implicit på grund av utebliven betalning av avgifter och efter att ha varit i Pausad tillstånd 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.

Relaterat innehåll

Video-självstudier