Invoice with Azure

​

Create an Azure Marketplace offer and plan​

1. Create a new Software as a Service offer from your partner portal and provide a name and alias.

2. In the Offer Setup tab, select Yes for Selling through Microsoft and No for using Microsoft’s license management service.

3. Click the Technical configuration tab to specify SaaS URL redirect for setup, Webhook URL, and a Microsoft Entra Application ID and Tenant ID. Retrieve these from the Azure portal.

4. Click the Plan overview tab to add plans for each rate card you defined in Metronome associated with this listing, and specify a plan ID and plan name.

5. Specify the pricing model in the Pricing and Availability tab.
   • Select the Flat Rate option with a monthly, yearly or multi-year Billing term with a $0 Price per payment.
   • Add one metering service dimension with ONLY these values:
     • ID set to usage_fee
     • Display name set to Usage Fee
     • Unit of measure set to billing unit
     • Price per unit set to .01
     • Quantity included set to 0

6. Test your offer using the Preview audience tab

​

Set up authentication for Metronome to meter on your behalf​

1. Go to your Azure portal and select the Microsoft Entra ID service (formerly known as the Azure Active Directory).

2. From the Microsoft Entra ID overview, click App registrations in the sidebar to view applications that are authenticated to access the marketplace.

3. Click the All applications tab and select the desired application based on the client ID (also known as the Application ID). This is the application you used to set up the marketplace listing.

4. Add application credentials to Metronome.
   • From the Application page, in the Essentials section, copy the Tenant ID and Application ID.
   • Click into the Client credentials to generate and copy a Client secret.
   
   • In Metronome, go to General Settings > Integrations > Available Integrations > Azure Marketplace card > Get Started.
   • Enter the Tenant ID , Application ID , and Client secret into their respective fields.
5. Click Save.

​

Provision Azure Marketplace customers in Metronome​

1. Go to an existing customer’s detail page in Metronome or create a new customer at Customers > Add New Customer.
2. Go to Settings > Available Integrations > Azure > Get Started.
3. Enter the Azure subscription ID.
4. Create a new contract for the customer that matches the details of the contract they signed with you in the marketplace. Include any credits and commits the customer has as part of the contract.
5. Under the Billing Configuration section of the configure contract flow, select Azure as the billing provider.

6. Alternatively, you can use the following endpoints to set up Azure as a customer’s billing provider and assign it to a contract
   • To set up a new customer configured with Azure:
     • Call the create customer endpoint
     • In the request payload, include customer_billing_provider_configurations:
       • In the configuration property, specify azure_subscription_id
     Copy

     Ask AI

     {
       // ...
       "customer_billing_provider_configurations": [
         {
           "billing_provider": "azure_marketplace",
           "configuration": {
             "azure_subscription_id": "<your Azure subscription ID>"
           },
           "delivery_method": "direct_to_billing_provider"
         }
       ]
     }
     

   • To configure an existing customer with Azure:
     • Call the set customer billing provider configurations endpoint
     • In the request payload, include your configuration
       • In the configuration property, specify azure_subscription_id
     Copy

     Ask AI

     {
       // ...
       {
         "billing_provider": "azure_marketplace",
         "customer_id": "<your customer id>",
         "configuration": {
           "azure_subscription_id": "<your Azure subscription ID>"
         },
         "delivery_method": "direct_to_billing_provider"
       }
     }
     

   • To set up a new contract with invoices metered to Azure:
     • Call the create contract endpoint
     • In the request payload, include billing_provider_configuration:
     Copy

     Ask AI

     {
       // ...
       "billing_provider_configuration": {
         "billing_provider": "azure_marketplace",
         "delivery_method": "direct_to_billing_provider"
       }
     }
     

​

What Metronome meters to Azure​

• Prepaid commits A contract in Metronome specifies a schedule over which the customer pays for their prepaid commit. Those inputs create one or more scheduled invoices. Metronome meters the amount the customer owes on the prepaid commit on the date associated with the service period of the scheduled invoice, not the created at date.
• Credits As credits on a Metronome contract are not paid for, Metronome only meters overages reflected on invoice totals after the credit has been drawn down in its entirety.
• Postpaid commits Metronome meters usage reflected on invoice totals throughout the duration of the contract. However, if the entirety of the postpaid commit isn’t consumed by the end of the contract, Metronome ignores the true-up invoice and doesn’t send it to the marketplace. This is because the true-up invoice isn’t finalized until after the Metronome grace period ends, at which point the metering endpoint for the marketplace has closed. This means you must handle the true-up in the marketplace directly.

​

Handle marketplace customer lifecycle events in Metronome and your app​

​

Limitations of Azure Marketplace offers​