Attributes
- idstring
Unique identifier for the object.
- metadataobject
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.
- priceobject
The price the customer is subscribed to.
- price.
idstring Unique identifier for the object.
- price.
objectstring String representing the object’s type. Objects of the same type share the same value.
- price.
activeboolean Whether the price can be used for new purchases.
- price.
billing_ schemeenum Describes how to compute the price per period. Either
per_
orunit tiered
.per_
indicates that the fixed amount (specified inunit unit_
oramount unit_
) will be charged per unit inamount_ decimal quantity
(for prices withusage_
), or per unit of total usage (for prices withtype=licensed usage_
).type=metered tiered
indicates that the unit pricing will be computed using a tiering strategy as defined using thetiers
andtiers_
attributes.mode Possible enum valuesper_
unit tiered
- price.
createdtimestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- price.
currencyenum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- price.
currency_ optionsnullable objectExpandable Prices defined in each available currency option. Each key must be a three-letter ISO currency code and a supported currency.
- price.
currency_options. <currency>. custom_ unit_ amountnullable object When set, provides configuration for the amount to be adjusted by the customer during Checkout Sessions and Payment Links.
- price.
currency_options. <currency>.custom_unit_amount. maximumnullable integer The maximum unit amount the customer can specify for this item.
- price.
currency_options. <currency>.custom_unit_amount. minimumnullable integer The minimum unit amount the customer can specify for this item. Must be at least the minimum charge amount.
- price.
currency_options. <currency>.custom_unit_amount. presetnullable integer The starting unit amount which can be updated by the customer.
- price.
currency_options. <currency>. tax_ behaviornullable enum Only required if a default tax behavior was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of
inclusive
,exclusive
, orunspecified
. Once specified as eitherinclusive
orexclusive
, it cannot be changed.Possible enum valuesexclusive
inclusive
unspecified
- price.
currency_options. <currency>. tiersnullable array of objectsExpandable Each element represents a pricing tier. This parameter requires
billing_
to be set toscheme tiered
. See also the documentation forbilling_
.scheme - price.
currency_options. <currency>.tiers. flat_ amountnullable integer Price for the entire tier.
- price.
currency_options. <currency>.tiers. flat_ amount_ decimalnullable decimal string Same as
flat_
, but contains a decimal value with at most 12 decimal places.amount - price.
currency_options. <currency>.tiers. unit_ amountnullable integer Per unit price for units relevant to the tier.
- price.
currency_options. <currency>.tiers. unit_ amount_ decimalnullable decimal string Same as
unit_
, but contains a decimal value with at most 12 decimal places.amount - price.
currency_options. <currency>.tiers. up_ tonullable integer Up to and including to this quantity will be contained in the tier.
- price.
currency_options. <currency>. unit_ amountnullable integer The unit amount in cents to be charged, represented as a whole integer if possible. Only set if
billing_
.scheme=per_ unit - price.
currency_options. <currency>. unit_ amount_ decimalnullable decimal string The unit amount in cents to be charged, represented as a decimal string with at most 12 decimal places. Only set if
billing_
.scheme=per_ unit
- price.
custom_ unit_ amountnullable object When set, provides configuration for the amount to be adjusted by the customer during Checkout Sessions and Payment Links.
- price.
custom_unit_amount. maximumnullable integer The maximum unit amount the customer can specify for this item.
- price.
custom_unit_amount. minimumnullable integer The minimum unit amount the customer can specify for this item. Must be at least the minimum charge amount.
- price.
custom_unit_amount. presetnullable integer The starting unit amount which can be updated by the customer.
- price.
livemodeboolean Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - price.
lookup_ keynullable string A lookup key used to retrieve prices dynamically from a static string. This may be up to 200 characters.
- price.
metadataobject 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.
- price.
nicknamenullable string A brief description of the price, hidden from customers.
- price.
productstringExpandable The ID of the product this price is associated with.
- price.
recurringnullable object The recurring components of a price such as
interval
andusage_
.type - price.
recurring. intervalenum The frequency at which a subscription is billed. One of
day
,week
,month
oryear
. - price.
recurring. interval_ countinteger The number of intervals (specified in the
interval
attribute) between subscription billings. For example,interval=month
andinterval_
bills every 3 months.count=3 - price.
recurring. meternullable string The meter tracking the usage of a metered price
- price.
recurring. usage_ typeenum Configures how the quantity per period should be determined. Can be either
metered
orlicensed
.licensed
automatically bills thequantity
set when adding it to a subscription.metered
aggregates the total usage based on usage records. Defaults tolicensed
.
- price.
tax_ behaviornullable enum Only required if a default tax behavior was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of
inclusive
,exclusive
, orunspecified
. Once specified as eitherinclusive
orexclusive
, it cannot be changed.Possible enum valuesexclusive
inclusive
unspecified
- price.
tiersnullable array of objectsExpandable Each element represents a pricing tier. This parameter requires
billing_
to be set toscheme tiered
. See also the documentation forbilling_
.scheme - price.
tiers. flat_ amountnullable integer Price for the entire tier.
- price.
tiers. flat_ amount_ decimalnullable decimal string Same as
flat_
, but contains a decimal value with at most 12 decimal places.amount - price.
tiers. unit_ amountnullable integer Per unit price for units relevant to the tier.
- price.
tiers. unit_ amount_ decimalnullable decimal string Same as
unit_
, but contains a decimal value with at most 12 decimal places.amount - price.
tiers. up_ tonullable integer Up to and including to this quantity will be contained in the tier.
- price.
tiers_ modenullable enum Defines if the tiering price should be
graduated
orvolume
based. Involume
-based tiering, the maximum quantity within a period determines the per unit price. Ingraduated
tiering, pricing can change as the quantity grows.Possible enum valuesgraduated
volume
- price.
transform_ quantitynullable object Apply a transformation to the reported usage or set quantity before computing the amount billed. Cannot be combined with
tiers
.- price.
transform_quantity. divide_ byinteger Divide usage by this number.
- price.
transform_quantity. roundenum After division, either round the result
up
ordown
.
- price.
typeenum One of
one_
ortime recurring
depending on whether the price is for a one-time purchase or a recurring (subscription) purchase.Possible enum valuesone_
time recurring
- price.
unit_ amountnullable integer The unit amount in cents to be charged, represented as a whole integer if possible. Only set if
billing_
.scheme=per_ unit - price.
unit_ amount_ decimalnullable decimal string The unit amount in cents to be charged, represented as a decimal string with at most 12 decimal places. Only set if
billing_
.scheme=per_ unit
- quantitynullable integer
The quantity of the plan to which the customer should be subscribed.
- subscriptionstring
The
subscription
thissubscription_
belongs to.item
More attributes
- objectstring
String representing the object’s type. Objects of the same type share the same value.
- billing_
thresholdsnullable object Define thresholds at which an invoice will be sent, and the related subscription advanced to a new billing period
- billing_thresholds.
usage_ gtenullable integer Usage threshold that triggers the subscription to create an invoice
- createdinteger
Time at which the object was created. Measured in seconds since the Unix epoch.
- current_
period_ endtimestamp The end time of this subscription item’s current billing period.
- current_
period_ starttimestamp The start time of this subscription item’s current billing period.
- discountsarray of stringsExpandable
The discounts applied to the subscription item. Subscription item discounts are applied before subscription discounts. Use
expand[]=discounts
to expand each discount. - tax_
ratesnullable array of objects The tax rates which apply to this
subscription_
. When set, theitem default_
on the subscription do not apply to thistax_ rates subscription_
.item - tax_rates.
idstring Unique identifier for the object.
- tax_rates.
objectstring String representing the object’s type. Objects of the same type share the same value.
- tax_rates.
activeboolean Defaults to
true
. When set tofalse
, this tax rate cannot be used with new applications or Checkout Sessions, but will still work for subscriptions and invoices that already have it set. - tax_rates.
countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- tax_rates.
createdtimestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- tax_rates.
descriptionnullable string An arbitrary string attached to the tax rate for your internal use only. It will not be visible to your customers.
- tax_rates.
display_ namestring The display name of the tax rates as it will appear to your customer on their receipt email, PDF, and the hosted invoice page.
- tax_rates.
effective_ percentagenullable float Actual/effective tax rate percentage out of 100. For tax calculations with automatic_tax[enabled]=true, this percentage reflects the rate actually used to calculate tax based on the product’s taxability and whether the user is registered to collect taxes in the corresponding jurisdiction.
- tax_rates.
flat_ amountnullable object The amount of the tax rate when the
rate_
istype flat_
. Tax rates withamount rate_
type percentage
can vary based on the transaction, resulting in this field beingnull
. This field exposes the amount and currency of the flat tax rate.- tax_rates.
flat_amount. amountinteger Amount of the tax when the
rate_
istype flat_
. This positive integer represents how much to charge in the smallest currency unit (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99).amount - tax_rates.
flat_amount. currencystring Three-letter ISO currency code, in lowercase.
- tax_rates.
inclusiveboolean This specifies if the tax rate is inclusive or exclusive.
- tax_rates.
jurisdictionnullable string The jurisdiction for the tax rate. You can use this label field for tax reporting purposes. It also appears on your customer’s invoice.
- tax_rates.
jurisdiction_ levelnullable enum The level of the jurisdiction that imposes this tax rate. Will be
null
for manually defined tax rates.Possible enum valuescity
country
county
district
multiple
state
- tax_rates.
livemodeboolean Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - tax_rates.
metadatanullable object 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.
- tax_rates.
percentagefloat Tax rate percentage out of 100. For tax calculations with automatic_tax[enabled]=true, this percentage includes the statutory tax rate of non-taxable jurisdictions.
- tax_rates.
rate_ typenullable enum Indicates the type of tax rate applied to the taxable amount. This value can be
null
when no tax applies to the location. This field is only present for TaxRates created by Stripe Tax.Possible enum valuesflat_
amount A fixed amount applied as tax, regardless of the taxable amount, such as a retail delivery fee.
percentage
A tax rate expressed as a percentage of the taxable amount, such as the sales tax rate in California.
- tax_rates.
statenullable string ISO 3166-2 subdivision code, without country prefix. For example, “NY” for New York, United States.
- tax_rates.
tax_ typenullable enum The high-level tax type, such as
vat
orsales_
.tax Possible enum valuesamusement_
tax Amusement Tax
communications_
tax Communications Tax
gst
Goods and Services Tax
hst
Harmonized Sales Tax
igst
Integrated Goods and Services Tax
jct
Japanese Consumption Tax
lease_
tax Chicago Lease Tax
pst
Provincial Sales Tax
qst
Quebec Sales Tax
retail_
delivery_ fee Retail Delivery Fee
Show 4 more
{ "id": "si_NcLYdDxLHxlFo7", "object": "subscription_item", "created": 1680126546, "metadata": {}, "price": { "id": "price_1Mr6rdLkdIwHu7ixwPmiybbR", "object": "price", "active": true, "billing_scheme": "per_unit", "created": 1680126545, "currency": "usd", "custom_unit_amount": null, "discounts": null, "livemode": false, "lookup_key": null, "metadata": {}, "nickname": null, "product": "prod_NcLYGKH0eY5b8s", "recurring": { "interval": "month", "interval_count": 1, "trial_period_days": null, "usage_type": "licensed" }, "tax_behavior": "unspecified", "tiers_mode": null, "transform_quantity": null, "type": "recurring", "unit_amount": 1000, "unit_amount_decimal": "1000" }, "quantity": 2, "subscription": "sub_1Mr6rbLkdIwHu7ix4Xm9Ahtd", "tax_rates": []}