Define subscription pricing

Create the list prices for your subscription offerings by first creating your subscription products and then adding them to your rate card.

Create a subscription product

Create a subscription product in the Metronome app or with the API using the /v1/contract-pricing/products/create end point. Create a subscription product for each type of subscription you offer. For example, if you offer a Good, Better, and Best plan, create a product for each.

Optionally add seat id as presentation group key for usage products

If planning to support a seat based credit model, ensure that all applicable usage products have a seat_id presentation group key set on them. This will be used to determine the usage on a per product, per seat basis. See an example of a usage event with a seat_id property below:

{
  "event_type": "video_generation",
  "properties": {
    "model_name": "claude-3-opus",
    "resolution": "1080p",
    "environment": "production",
    "video_duration_seconds": 20,
    "seat_id": "example@metronome.com"
  },
  "transaction_id": "21f00039-0572-4f63-bf0f-b19faa3d10f8",
  "customer_id": "94fbf9f3-2826-4503-8446-013c68817744",
  "timestamp": "2025-10-15T15:23:48.751Z"
}

Add a subscription product to a rate card

Add your subscription product(s) to a rate card with the Metronome app or the API. Your rate card acts as your list price for your subscription offering based on a quantity of 1. Quantity amount and associated credits are configured later, during the contract creation process. When using the API to add rates to a rate card:

Add your subscription to the rate card as a flat rate.
Specify a price and billing_frequency.
Specify an entitlement state. If you have more than one subscription rate on your rate card, Metronome recommends defaulting them to false and enabling them when provisioning a contract.

This call shows an example of using rate-cards/addRate to add subscription products to a rate card:

{
    "entitled": false,
    "product_id": "660445c5-e409-42dc-9aac-07df3b2cde35",
    "rate_card_id": "a7bc3775-b651-46b6-b7e4-d225a7e55c4c",
    "rate_type": "flat",
    "starting_at": "2025-04-01T00:00:00.000Z",
    "price": 500,
    "billing_frequency": "MONTHLY"
}

GET STARTED

IMPLEMENT METRONOME

EVENTS

PRICING & PACKAGING

CUSTOMERS & BILLING

INVOICING

REPORTING & INSIGHTS

PLATFORM CONFIGURATION

Define subscription pricing

Create a subscription product

Optionally add seat id as presentation group key for usage products

Add a subscription product to a rate card

​Create a subscription product​

​Optionally add seat id as presentation group key for usage products

​Add a subscription product to a rate card​

Create a subscription product

Optionally add seat id as presentation group key for usage products

Add a subscription product to a rate card