Contracts

Last updated: August 5, 2025

Overview

When a prospective customer (buyer) purchases a SaaS offer from Azure Marketplace, it creates a software as a service (SaaS) subscription (contract) in the Azure portal.

Contracts (a.k.a Subscription)

A buyer's subscription can exist in different states of its lifecycle. Buyers have the liberty to change plan & increase or decrease the number of users, cancel subscription, edit recurring billing, etc., from the Azure portal. More details can be found here.

Contract Activation

Sellers can activate a subscription that is present in the Pending tab of the Buyers screen.

5ebebf0-Screenshot_2023-07-10_at_6.03.54_PM.png

Contract Metadata

Subscription metadata is synced from Azure periodically via the Get Subscription API. This will eventually reflect the latest subscription data.

YAML

id: e8be44e6-a931-467b-d4nc-20427fcbb8b1
name: subscription_name_by_buyer
saas_subscription_status: Subscribed
term:
  start_date: 2023-07-05
  end_date: 2023-08-03
  billing_term: 1 Month
is_test: false
plan_id: starter
created_at: 2023-06-23 13:02:20
offer_id: sentiment_analysis_app_source_api_15_05_2023-preview
auto_renew: true
purchaser:
  pu_id: 1003200283490BB9
  emai_id: yash.ubale@datadome.io
  object_id: ba6cbee5-3665-4dab-927a-5c2343eb376e
  tenant_id: 7b37ebfe-eb76-43e8-a5bc-67e18810e2a3
beneficiary:
  pu_id: 1003200283490BB9
  emai_id: yash.ubale@datadome.io
  object_id: ba6cbee5-3665-4dab-927a-5c2343eb376e
  tenant_id: 7b37ebfe-eb76-43e8-a5bc-67e18810e2a3
is_free_trial: false
publisher_id: datadomellc1666884843020

Contract States

State	Description
PendingFulfillmentStart	Buyer buys a plan in a listing, and a subscription is created
Subscribed	Seller activates the subscription that is waiting in the PendingFulfillmentStart state After changing the plan subscription state doesn't change After changing the number of users subscription state doesn't change
Suspended	Subscription gets suspended if payment is not received (30 days' grace)
Unsubscribed	Buyer unsubscribed to a subscription via the Azure Portal, or payment is not received for a suspended subscription (after 30 days' grace)

Contract Events

Certain actions by sellers and buyers initiate state changes in the contract, generating events. These events are visible in the events section of the contract.

Event Name	Description
Azure Contract New	Buyer purchases a plan from your listing
Azure Contract Registered	Buyer completes the registration process
Azure Contract Activated	Seller activates a subscription in the pending state
Azure Contract Renewed	The contract gets auto-renewed post expiry
Azure Contract Plan Changed	Buyer changes the plan of the subscription
Azure Contract Quantity Changed	Buyer changes the number of users for the purchased plan
Azure Contract Suspended	Subscription gets suspended if payment is not received (30 days' grace)
Azure Contract Unsubscribed	Buyer unsubscribed to a subscription via the Azure Portal, or payment is not received for a suspended subscription (after 30 days' grace)
Azure Contract Reinstated	Subscription gets reinstated if payment is received for a suspended subscription within a 30-day grace period