License Fees v2
A LicenseFee describes quantity-based pricing such as seat-based pricing.
Attributes
- idstring
The ID of the LicenseFee.
- objectstring, value is "v2.billing.license_fee"
String representing the object’s type. Objects of the same type share the same value of the object field.
- activeboolean
Whether this LicenseFee is active. Inactive LicenseFees cannot be used in new activations or be modified.
- createdtimestamp
Timestamp of when the object was created.
- currencystring
The currency of this LicenseFee.
- display_
namestring A customer-facing name for the LicenseFee. This name is used in Stripe-hosted products like the Customer Portal and Checkout. It does not show up on Invoices. Maximum length of 250 characters.
- latest_
versionstring The ID of the LicenseFee’s most recently created version.
- licensed_
itemobject The LicensedItem that this license fee binds to.
- live_
versionstring The ID of the version that will be used by all Subscriptions when no specific version is specified.
- livemodeboolean
Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - lookup_
keynullable string An internal key you can use to search for a particular LicenseFee. Maximum length of 200 characters.
- metadatanullable map
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- service_
intervalenum The interval for assessing service.
Possible enum valuesday
Assess service by days.
month
Assess service by months.
week
Assess service by weeks.
year
Assess service by years.
- service_
interval_ countinteger The length of the interval for assessing service. For example, set this to 3 and
service_
tointerval "month"
in order to specify quarterly service. - tax_
behaviorenum The Stripe Tax tax behavior - whether the license fee is inclusive or exclusive of tax.
Possible enum valuesexclusive
Price excludes tax.
inclusive
Price includes tax.
- tiering_
modenullable enum Defines whether the tiering price should be graduated or volume-based. In volume-based tiering, the maximum quantity within a period determines the per-unit price. In graduated tiering, the pricing changes as the quantity grows into new tiers. Can only be set if
tiers
is set.Possible enum valuesgraduated
Use graduated tiering: the pricing at each tier applies to the quantity within that tier.
volume
Use volume-based tiering: the maximum quantity within a period determines the per-unit price for that period.
- tiersarray of objects
Each element represents a pricing tier. Cannot be set if
unit_
is provided.amount - transform_
quantitynullable object Apply a transformation to the reported usage or set quantity before computing the amount billed.
- unit_
amountnullable string The per-unit amount to be charged, represented as a decimal string in minor currency units with at most 12 decimal places. Cannot be set if
tiers
is provided.
{ "active": true, "created": "2025-01-01T00:00:00.000Z", "currency": "usd", "display_name": "Monthly fee", "id": "licf_61SbQ4ZVMJ2ESqq2416S40x4RVA8P2F2ShZStd6x6RCy", "latest_version": "licfv_61SbQ4ZVMJ2ESqq2416S40x4RVA8P2F2ShZStd6x6RCy", "licensed_item": { "created": "2025-01-01T00:00:00.000Z", "display_name": "Monthly fee item", "id": "bli_61SbQ4ZVMJ2ESqq2416S40x4RVA8P2F2ShZStd6x6RCy", "lookup_key": "monthly-fee-item", "metadata": { "key": "value" }, "object": "v2.billing.licensed_item", "unit_label": "per month", "livemode": true }, "live_version": "licfv_61SbQ4ZVMJ2ESqq2416S40x4RVA8P2F2ShZStd6x6RCy", "lookup_key": "monthly-fee", "metadata": { "key": "value" }, "object": "v2.billing.license_fee", "service_interval": "month", "service_interval_count": 1, "tax_behavior": "exclusive", "tiering_mode": "graduated", "tiers": [ { "flat_amount": null, "unit_amount": "20.00", "up_to_decimal": null, "up_to_inf": "inf" } ], "transform_quantity": { "divide_by": 1000, "round": "down" }, "unit_amount": "20.00", "livemode": true}
Attributes
- idstring
The ID of the LicenseFeeVersion.
- objectstring, value is "v2.billing.license_fee_version"
String representing the object’s type. Objects of the same type share the same value of the object field.
- createdtimestamp
Timestamp of when the object was created.
- license_
fee_ idstring The ID of the parent LicenseFee.
- livemodeboolean
Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - tiering_
modenullable enum Defines whether the tiering price should be graduated or volume-based. In volume-based tiering, the maximum quantity within a period determines the per-unit price. In graduated tiering, the pricing changes as the quantity grows into new tiers. Can only be set if
tiers
is set.Possible enum valuesgraduated
Use graduated tiering: the pricing at each tier applies to the quantity within that tier.
volume
Use volume-based tiering: the maximum quantity within a period determines the per-unit price for that period.
- tiersarray of objects
Each element represents a pricing tier. Cannot be set if
unit_
is provided.amount - transform_
quantitynullable object Apply a transformation to the reported usage or set quantity before computing the amount billed.
- unit_
amountnullable string The per-unit amount to be charged, represented as a decimal string in minor currency units with at most 12 decimal places. Cannot be set if
tiers
is provided.
{ "created": "2025-01-01T00:00:00.000Z", "id": "licfv_61SbQ4ZVMJ2ESqq2416S40x4RVA8P2F2ShZStd6x6RCy", "license_fee_id": "licf_61SbQ4ZVMJ2ESqq2416S40x4RVA8P2F2ShZStd6x6RCy", "object": "v2.billing.license_fee_version", "tiering_mode": "graduated", "tiers": [ { "flat_amount": null, "unit_amount": "20.00", "up_to_decimal": null, "up_to_inf": "inf" } ], "transform_quantity": { "divide_by": 1000, "round": "down" }, "unit_amount": "20.0", "livemode": true}
Create a LicenseFee object.
Learn more about calling API v2 endpoints.Parameters
- currencystringRequired
The currency of this LicenseFee.
- display_
namestringRequired A customer-facing name for the LicenseFee. This name is used in Stripe-hosted products like the Customer Portal and Checkout. It does not show up on Invoices. Maximum length of 250 characters.
- licensed_
itemstringRequired The LicensedItem that this rate binds to.
- service_
intervalenumRequired The interval for assessing service. For example, a monthly LicenseFee with a rate of $1 for the first 10 “workloads” and $2 thereafter means “$1 per workload up to 10 workloads during a month of service.” This is similar to but distinct from billing interval; the service interval deals with the rate at which the customer accumulates fees, while the billing interval in Cadence deals with the rate the customer is billed.
Possible enum valuesday
Assess service by days.
month
Assess service by months.
week
Assess service by weeks.
year
Assess service by years.
- service_
interval_ countintegerRequired The length of the interval for assessing service. For example, set this to 3 and
service_
tointerval "month"
in order to specify quarterly service. - tax_
behaviorenumRequired The Stripe Tax tax behavior - whether the license fee is inclusive or exclusive of tax.
Possible enum valuesexclusive
Price excludes tax.
inclusive
Price includes tax.
- lookup_
keystring An internal key you can use to search for a particular LicenseFee. Maximum length of 200 characters.
- metadatamap
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- tiering_
modeenum Defines whether the tiered price should be graduated or volume-based. In volume-based tiering, the maximum quantity within a period determines the per-unit price. In graduated tiering, the pricing changes as the quantity grows into new tiers. Can only be set if
tiers
is set.Possible enum valuesgraduated
Use graduated tiering: the pricing at each tier applies to the quantity within that tier.
volume
Use volume-based tiering: the maximum quantity within a period determines the per-unit price for that period.
- tiersarray of objects
Each element represents a pricing tier. Cannot be set if
unit_
is provided.amount - transform_
quantityobject Apply a transformation to the reported usage or set quantity before computing the amount billed.
- unit_
amountstring The per-unit amount to be charged, represented as a decimal string in minor currency units with at most 12 decimal places. Cannot be set if
tiers
is provided.
Returns
Response attributes
- idstring
The ID of the LicenseFee.
- objectstring, value is "v2.billing.license_fee"
String representing the object’s type. Objects of the same type share the same value of the object field.
- activeboolean
Whether this LicenseFee is active. Inactive LicenseFees cannot be used in new activations or be modified.
- createdtimestamp
Timestamp of when the object was created.
- currencystring
The currency of this LicenseFee.
- display_
namestring A customer-facing name for the LicenseFee. This name is used in Stripe-hosted products like the Customer Portal and Checkout. It does not show up on Invoices. Maximum length of 250 characters.
- latest_
versionstring The ID of the LicenseFee’s most recently created version.
- licensed_
itemobject The LicensedItem that this license fee binds to.
- live_
versionstring The ID of the version that will be used by all Subscriptions when no specific version is specified.
- livemodeboolean
Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - lookup_
keynullable string An internal key you can use to search for a particular LicenseFee. Maximum length of 200 characters.
- metadatanullable map
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- service_
intervalenum The interval for assessing service.
Possible enum valuesday
Assess service by days.
month
Assess service by months.
week
Assess service by weeks.
year
Assess service by years.
- service_
interval_ countinteger The length of the interval for assessing service. For example, set this to 3 and
service_
tointerval "month"
in order to specify quarterly service. - tax_
behaviorenum The Stripe Tax tax behavior - whether the license fee is inclusive or exclusive of tax.
Possible enum valuesexclusive
Price excludes tax.
inclusive
Price includes tax.
- tiering_
modenullable enum Defines whether the tiering price should be graduated or volume-based. In volume-based tiering, the maximum quantity within a period determines the per-unit price. In graduated tiering, the pricing changes as the quantity grows into new tiers. Can only be set if
tiers
is set.Possible enum valuesgraduated
Use graduated tiering: the pricing at each tier applies to the quantity within that tier.
volume
Use volume-based tiering: the maximum quantity within a period determines the per-unit price for that period.
- tiersarray of objects
Each element represents a pricing tier. Cannot be set if
unit_
is provided.amount - transform_
quantitynullable object Apply a transformation to the reported usage or set quantity before computing the amount billed.
- unit_
amountnullable string The per-unit amount to be charged, represented as a decimal string in minor currency units with at most 12 decimal places. Cannot be set if
tiers
is provided.
Returned when the provided display_name is longer than the maximum length of 100 characters.
Returned when the provided billable_item ID cannot be found.
{ "active": true, "created": "2025-01-01T00:00:00.000Z", "currency": "usd", "display_name": "Monthly fee", "id": "licf_61SbQ4ZVMJ2ESqq2416S40x4RVA8P2F2ShZStd6x6RCy", "latest_version": "licfv_61SbQ4ZVMJ2ESqq2416S40x4RVA8P2F2ShZStd6x6RCy", "licensed_item": { "created": "2025-01-01T00:00:00.000Z", "display_name": "Monthly fee item", "id": "bli_61SbQ4ZVMJ2ESqq2416S40x4RVA8P2F2ShZStd6x6RCy", "lookup_key": "monthly-fee-item", "metadata": { "key": "value" }, "object": "v2.billing.licensed_item", "unit_label": "per month", "livemode": true }, "live_version": "licfv_61SbQ4ZVMJ2ESqq2416S40x4RVA8P2F2ShZStd6x6RCy", "lookup_key": "monthly-fee", "metadata": { "key": "value" }, "object": "v2.billing.license_fee", "service_interval": "month", "service_interval_count": 1, "tax_behavior": "exclusive", "tiers": [], "unit_amount": "20.00", "livemode": true}
Update a LicenseFee object.
Learn more about calling API v2 endpoints.Parameters
- display_
namestringRequired A customer-facing name for the LicenseFee. This name is used in Stripe-hosted products like the Customer Portal and Checkout. It does not show up on Invoices. Maximum length of 250 characters.
- idstringRequired
The ID of the LicenseFee to update.
- live_
versionstring Changes the version that new LicenseFee will use. Providing
live_
will set the LicenseFee’sversion = "latest" live_
to its latest version.version - lookup_
keystring An internal key you can use to search for a particular LicenseFee. Maximum length of 200 characters.
- metadatamap
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- tiering_
modeenum Defines whether the tiered price should be graduated or volume-based. In volume-based tiering, the maximum quantity within a period determines the per-unit price. In graduated tiering, the pricing changes as the quantity grows into new tiers. Can only be set if
tiers
is set.Possible enum valuesgraduated
Use graduated tiering: the pricing at each tier applies to the quantity within that tier.
volume
Use volume-based tiering: the maximum quantity within a period determines the per-unit price for that period.
- tiersarray of objects
Each element represents a pricing tier. Cannot be set if
unit_
is provided.amount - transform_
quantityobject Apply a transformation to the reported usage or set quantity before computing the amount billed.
- unit_
amountstring The per-unit amount to be charged, represented as a decimal string in minor currency units with at most 12 decimal places. Cannot be set if
tiers
is provided.
Returns
Response attributes
- idstring
The ID of the LicenseFee.
- objectstring, value is "v2.billing.license_fee"
String representing the object’s type. Objects of the same type share the same value of the object field.
- activeboolean
Whether this LicenseFee is active. Inactive LicenseFees cannot be used in new activations or be modified.
- createdtimestamp
Timestamp of when the object was created.
- currencystring
The currency of this LicenseFee.
- display_
namestring A customer-facing name for the LicenseFee. This name is used in Stripe-hosted products like the Customer Portal and Checkout. It does not show up on Invoices. Maximum length of 250 characters.
- latest_
versionstring The ID of the LicenseFee’s most recently created version.
- licensed_
itemobject The LicensedItem that this license fee binds to.
- live_
versionstring The ID of the version that will be used by all Subscriptions when no specific version is specified.
- livemodeboolean
Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - lookup_
keynullable string An internal key you can use to search for a particular LicenseFee. Maximum length of 200 characters.
- metadatanullable map
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- service_
intervalenum The interval for assessing service.
Possible enum valuesday
Assess service by days.
month
Assess service by months.
week
Assess service by weeks.
year
Assess service by years.
- service_
interval_ countinteger The length of the interval for assessing service. For example, set this to 3 and
service_
tointerval "month"
in order to specify quarterly service. - tax_
behaviorenum The Stripe Tax tax behavior - whether the license fee is inclusive or exclusive of tax.
Possible enum valuesexclusive
Price excludes tax.
inclusive
Price includes tax.
- tiering_
modenullable enum Defines whether the tiering price should be graduated or volume-based. In volume-based tiering, the maximum quantity within a period determines the per-unit price. In graduated tiering, the pricing changes as the quantity grows into new tiers. Can only be set if
tiers
is set.Possible enum valuesgraduated
Use graduated tiering: the pricing at each tier applies to the quantity within that tier.
volume
Use volume-based tiering: the maximum quantity within a period determines the per-unit price for that period.
- tiersarray of objects
Each element represents a pricing tier. Cannot be set if
unit_
is provided.amount - transform_
quantitynullable object Apply a transformation to the reported usage or set quantity before computing the amount billed.
- unit_
amountnullable string The per-unit amount to be charged, represented as a decimal string in minor currency units with at most 12 decimal places. Cannot be set if
tiers
is provided.
Returned when the provided display_name is longer than the maximum length of 100 characters.
{ "active": true, "created": "2025-01-01T00:00:00.000Z", "currency": "usd", "display_name": "Updated Monthly fee", "id": "licf_61SbQ4ZVMJ2ESqq2416S40x4RVA8P2F2ShZStd6x6RCy", "latest_version": "licfv_61SbQ4ZVMJ2ESqq2416S40x4RVA8P2F2ShZStd6x6RCy", "licensed_item": { "created": "2025-01-01T00:00:00.000Z", "display_name": "Monthly fee item", "id": "bli_61SbQ4ZVMJ2ESqq2416S40x4RVA8P2F2ShZStd6x6RCy", "lookup_key": "monthly-fee-item", "metadata": { "key": "value" }, "object": "v2.billing.licensed_item", "unit_label": "per month", "livemode": true }, "live_version": "licfv_61SbQ4ZVMJ2ESqq2416S40x4RVA8P2F2ShZStd6x6RCy", "lookup_key": "updated-monthly-fee", "metadata": { "existing_key": "updated_value", "new_key": "new_value" }, "object": "v2.billing.license_fee", "service_interval": "month", "service_interval_count": 1, "tax_behavior": "exclusive", "tiers": [], "unit_amount": "25.00", "livemode": true}