published on Friday, Aug 14, 2026 by Pulumi
published on Friday, Aug 14, 2026 by Pulumi
Prices define the unit cost, currency, and (optional) billing cycle for both recurring and one-time purchases of products. Products help you track inventory or provisioning, and prices help you track payment terms. Different physical goods or levels of service should be represented by products, and pricing options should be represented by prices. This approach lets you change prices without having to change your provisioning scheme.
For example, you might have a single “gold” product that has prices for $10/month, $100/year, and €9 once.
Related guides: Set up a subscription, create an invoice, and more about products and prices.
Create Price Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Price(name: string, args: PriceArgs, opts?: CustomResourceOptions);@overload
def Price(resource_name: str,
args: PriceArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Price(resource_name: str,
opts: Optional[ResourceOptions] = None,
currency: Optional[str] = None,
product: Optional[str] = None,
recurrings: Optional[Sequence[PriceRecurringArgs]] = None,
currency_options: Optional[Sequence[PriceCurrencyOptionArgs]] = None,
custom_unit_amounts: Optional[Sequence[PriceCustomUnitAmountArgs]] = None,
lookup_key: Optional[str] = None,
metadata: Optional[Mapping[str, str]] = None,
nickname: Optional[str] = None,
active: Optional[bool] = None,
billing_scheme: Optional[str] = None,
tax_behavior: Optional[str] = None,
product_datas: Optional[Sequence[PriceProductDataArgs]] = None,
tiers: Optional[Sequence[PriceTierArgs]] = None,
tiers_mode: Optional[str] = None,
transfer_lookup_key: Optional[bool] = None,
transform_quantity: Optional[PriceTransformQuantityArgs] = None,
unit_amount: Optional[float] = None,
unit_amount_decimal: Optional[str] = None)func NewPrice(ctx *Context, name string, args PriceArgs, opts ...ResourceOption) (*Price, error)public Price(string name, PriceArgs args, CustomResourceOptions? opts = null)type: stripe:Price
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
resource "stripe_price" "name" {
# resource properties
}Parameters
- name string
- The unique name of the resource.
- args PriceArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args PriceArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args PriceArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args PriceArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args PriceArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var priceResource = new Stripe.Price("priceResource", new()
{
Currency = "string",
Product = "string",
Recurrings = new[]
{
new Stripe.Inputs.PriceRecurringArgs
{
Interval = "string",
IntervalCount = 0.0,
Meter = "string",
TrialPeriodDays = 0.0,
UsageType = "string",
},
},
CurrencyOptions = new[]
{
new Stripe.Inputs.PriceCurrencyOptionArgs
{
Key = "string",
CustomUnitAmounts = new[]
{
new Stripe.Inputs.PriceCurrencyOptionCustomUnitAmountArgs
{
Enabled = false,
Maximum = 0.0,
Minimum = 0.0,
Preset = 0.0,
},
},
TaxBehavior = "string",
Tiers = new[]
{
new Stripe.Inputs.PriceCurrencyOptionTierArgs
{
UpTo = "string",
FlatAmount = 0.0,
FlatAmountDecimal = "string",
UnitAmount = 0.0,
UnitAmountDecimal = "string",
},
},
UnitAmount = 0.0,
UnitAmountDecimal = "string",
},
},
CustomUnitAmounts = new[]
{
new Stripe.Inputs.PriceCustomUnitAmountArgs
{
Enabled = false,
Maximum = 0.0,
Minimum = 0.0,
Preset = 0.0,
},
},
LookupKey = "string",
Metadata =
{
{ "string", "string" },
},
Nickname = "string",
Active = false,
BillingScheme = "string",
TaxBehavior = "string",
ProductDatas = new[]
{
new Stripe.Inputs.PriceProductDataArgs
{
Name = "string",
Active = false,
Id = "string",
Metadata =
{
{ "string", "string" },
},
StatementDescriptor = "string",
TaxCode = "string",
UnitLabel = "string",
},
},
Tiers = new[]
{
new Stripe.Inputs.PriceTierArgs
{
UpTo = "string",
FlatAmount = 0.0,
FlatAmountDecimal = "string",
UnitAmount = 0.0,
UnitAmountDecimal = "string",
},
},
TiersMode = "string",
TransferLookupKey = false,
TransformQuantity = new Stripe.Inputs.PriceTransformQuantityArgs
{
DivideBy = 0.0,
Round = "string",
},
UnitAmount = 0.0,
UnitAmountDecimal = "string",
});
example, err := stripe.NewPrice(ctx, "priceResource", &stripe.PriceArgs{
Currency: pulumi.String("string"),
Product: pulumi.String("string"),
Recurrings: stripe.PriceRecurringArray{
&stripe.PriceRecurringArgs{
Interval: pulumi.String("string"),
IntervalCount: pulumi.Float64(0),
Meter: pulumi.String("string"),
TrialPeriodDays: pulumi.Float64(0),
UsageType: pulumi.String("string"),
},
},
CurrencyOptions: stripe.PriceCurrencyOptionArray{
&stripe.PriceCurrencyOptionArgs{
Key: pulumi.String("string"),
CustomUnitAmounts: stripe.PriceCurrencyOptionCustomUnitAmountArray{
&stripe.PriceCurrencyOptionCustomUnitAmountArgs{
Enabled: pulumi.Bool(false),
Maximum: pulumi.Float64(0),
Minimum: pulumi.Float64(0),
Preset: pulumi.Float64(0),
},
},
TaxBehavior: pulumi.String("string"),
Tiers: stripe.PriceCurrencyOptionTierArray{
&stripe.PriceCurrencyOptionTierArgs{
UpTo: pulumi.String("string"),
FlatAmount: pulumi.Float64(0),
FlatAmountDecimal: pulumi.String("string"),
UnitAmount: pulumi.Float64(0),
UnitAmountDecimal: pulumi.String("string"),
},
},
UnitAmount: pulumi.Float64(0),
UnitAmountDecimal: pulumi.String("string"),
},
},
CustomUnitAmounts: stripe.PriceCustomUnitAmountArray{
&stripe.PriceCustomUnitAmountArgs{
Enabled: pulumi.Bool(false),
Maximum: pulumi.Float64(0),
Minimum: pulumi.Float64(0),
Preset: pulumi.Float64(0),
},
},
LookupKey: pulumi.String("string"),
Metadata: pulumi.StringMap{
"string": pulumi.String("string"),
},
Nickname: pulumi.String("string"),
Active: pulumi.Bool(false),
BillingScheme: pulumi.String("string"),
TaxBehavior: pulumi.String("string"),
ProductDatas: stripe.PriceProductDataArray{
&stripe.PriceProductDataArgs{
Name: pulumi.String("string"),
Active: pulumi.Bool(false),
Id: pulumi.String("string"),
Metadata: pulumi.StringMap{
"string": pulumi.String("string"),
},
StatementDescriptor: pulumi.String("string"),
TaxCode: pulumi.String("string"),
UnitLabel: pulumi.String("string"),
},
},
Tiers: stripe.PriceTierArray{
&stripe.PriceTierArgs{
UpTo: pulumi.String("string"),
FlatAmount: pulumi.Float64(0),
FlatAmountDecimal: pulumi.String("string"),
UnitAmount: pulumi.Float64(0),
UnitAmountDecimal: pulumi.String("string"),
},
},
TiersMode: pulumi.String("string"),
TransferLookupKey: pulumi.Bool(false),
TransformQuantity: &stripe.PriceTransformQuantityArgs{
DivideBy: pulumi.Float64(0),
Round: pulumi.String("string"),
},
UnitAmount: pulumi.Float64(0),
UnitAmountDecimal: pulumi.String("string"),
})
resource "stripe_price" "priceResource" {
lifecycle {
create_before_destroy = true
}
currency = "string"
product = "string"
recurrings {
interval = "string"
interval_count = 0
meter = "string"
trial_period_days = 0
usage_type = "string"
}
currency_options {
key = "string"
custom_unit_amounts {
enabled = false
maximum = 0
minimum = 0
preset = 0
}
tax_behavior = "string"
tiers {
up_to = "string"
flat_amount = 0
flat_amount_decimal = "string"
unit_amount = 0
unit_amount_decimal = "string"
}
unit_amount = 0
unit_amount_decimal = "string"
}
custom_unit_amounts {
enabled = false
maximum = 0
minimum = 0
preset = 0
}
lookup_key = "string"
metadata = {
"string" = "string"
}
nickname = "string"
active = false
billing_scheme = "string"
tax_behavior = "string"
product_datas {
name = "string"
active = false
id = "string"
metadata = {
"string" = "string"
}
statement_descriptor = "string"
tax_code = "string"
unit_label = "string"
}
tiers {
up_to = "string"
flat_amount = 0
flat_amount_decimal = "string"
unit_amount = 0
unit_amount_decimal = "string"
}
tiers_mode = "string"
transfer_lookup_key = false
transform_quantity = {
divide_by = 0
round = "string"
}
unit_amount = 0
unit_amount_decimal = "string"
}
var priceResource = new Price("priceResource", PriceArgs.builder()
.currency("string")
.product("string")
.recurrings(PriceRecurringArgs.builder()
.interval("string")
.intervalCount(0.0)
.meter("string")
.trialPeriodDays(0.0)
.usageType("string")
.build())
.currencyOptions(PriceCurrencyOptionArgs.builder()
.key("string")
.customUnitAmounts(PriceCurrencyOptionCustomUnitAmountArgs.builder()
.enabled(false)
.maximum(0.0)
.minimum(0.0)
.preset(0.0)
.build())
.taxBehavior("string")
.tiers(PriceCurrencyOptionTierArgs.builder()
.upTo("string")
.flatAmount(0.0)
.flatAmountDecimal("string")
.unitAmount(0.0)
.unitAmountDecimal("string")
.build())
.unitAmount(0.0)
.unitAmountDecimal("string")
.build())
.customUnitAmounts(PriceCustomUnitAmountArgs.builder()
.enabled(false)
.maximum(0.0)
.minimum(0.0)
.preset(0.0)
.build())
.lookupKey("string")
.metadata(Map.of("string", "string"))
.nickname("string")
.active(false)
.billingScheme("string")
.taxBehavior("string")
.productDatas(PriceProductDataArgs.builder()
.name("string")
.active(false)
.id("string")
.metadata(Map.of("string", "string"))
.statementDescriptor("string")
.taxCode("string")
.unitLabel("string")
.build())
.tiers(PriceTierArgs.builder()
.upTo("string")
.flatAmount(0.0)
.flatAmountDecimal("string")
.unitAmount(0.0)
.unitAmountDecimal("string")
.build())
.tiersMode("string")
.transferLookupKey(false)
.transformQuantity(PriceTransformQuantityArgs.builder()
.divideBy(0.0)
.round("string")
.build())
.unitAmount(0.0)
.unitAmountDecimal("string")
.build());
price_resource = stripe.Price("priceResource",
currency="string",
product="string",
recurrings=[{
"interval": "string",
"interval_count": float(0),
"meter": "string",
"trial_period_days": float(0),
"usage_type": "string",
}],
currency_options=[{
"key": "string",
"custom_unit_amounts": [{
"enabled": False,
"maximum": float(0),
"minimum": float(0),
"preset": float(0),
}],
"tax_behavior": "string",
"tiers": [{
"up_to": "string",
"flat_amount": float(0),
"flat_amount_decimal": "string",
"unit_amount": float(0),
"unit_amount_decimal": "string",
}],
"unit_amount": float(0),
"unit_amount_decimal": "string",
}],
custom_unit_amounts=[{
"enabled": False,
"maximum": float(0),
"minimum": float(0),
"preset": float(0),
}],
lookup_key="string",
metadata={
"string": "string",
},
nickname="string",
active=False,
billing_scheme="string",
tax_behavior="string",
product_datas=[{
"name": "string",
"active": False,
"id": "string",
"metadata": {
"string": "string",
},
"statement_descriptor": "string",
"tax_code": "string",
"unit_label": "string",
}],
tiers=[{
"up_to": "string",
"flat_amount": float(0),
"flat_amount_decimal": "string",
"unit_amount": float(0),
"unit_amount_decimal": "string",
}],
tiers_mode="string",
transfer_lookup_key=False,
transform_quantity={
"divide_by": float(0),
"round": "string",
},
unit_amount=float(0),
unit_amount_decimal="string")
const priceResource = new stripe.Price("priceResource", {
currency: "string",
product: "string",
recurrings: [{
interval: "string",
intervalCount: 0,
meter: "string",
trialPeriodDays: 0,
usageType: "string",
}],
currencyOptions: [{
key: "string",
customUnitAmounts: [{
enabled: false,
maximum: 0,
minimum: 0,
preset: 0,
}],
taxBehavior: "string",
tiers: [{
upTo: "string",
flatAmount: 0,
flatAmountDecimal: "string",
unitAmount: 0,
unitAmountDecimal: "string",
}],
unitAmount: 0,
unitAmountDecimal: "string",
}],
customUnitAmounts: [{
enabled: false,
maximum: 0,
minimum: 0,
preset: 0,
}],
lookupKey: "string",
metadata: {
string: "string",
},
nickname: "string",
active: false,
billingScheme: "string",
taxBehavior: "string",
productDatas: [{
name: "string",
active: false,
id: "string",
metadata: {
string: "string",
},
statementDescriptor: "string",
taxCode: "string",
unitLabel: "string",
}],
tiers: [{
upTo: "string",
flatAmount: 0,
flatAmountDecimal: "string",
unitAmount: 0,
unitAmountDecimal: "string",
}],
tiersMode: "string",
transferLookupKey: false,
transformQuantity: {
divideBy: 0,
round: "string",
},
unitAmount: 0,
unitAmountDecimal: "string",
});
type: stripe:Price
properties:
active: false
billingScheme: string
currency: string
currencyOptions:
- customUnitAmounts:
- enabled: false
maximum: 0
minimum: 0
preset: 0
key: string
taxBehavior: string
tiers:
- flatAmount: 0
flatAmountDecimal: string
unitAmount: 0
unitAmountDecimal: string
upTo: string
unitAmount: 0
unitAmountDecimal: string
customUnitAmounts:
- enabled: false
maximum: 0
minimum: 0
preset: 0
lookupKey: string
metadata:
string: string
nickname: string
product: string
productDatas:
- active: false
id: string
metadata:
string: string
name: string
statementDescriptor: string
taxCode: string
unitLabel: string
recurrings:
- interval: string
intervalCount: 0
meter: string
trialPeriodDays: 0
usageType: string
taxBehavior: string
tiers:
- flatAmount: 0
flatAmountDecimal: string
unitAmount: 0
unitAmountDecimal: string
upTo: string
tiersMode: string
transferLookupKey: false
transformQuantity:
divideBy: 0
round: string
unitAmount: 0
unitAmountDecimal: string
Price Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The Price resource accepts the following input properties:
- Currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- Active bool
- Whether the price can be used for new purchases.
- Billing
Scheme string - Describes how to compute the price per period. Either
per_unitortiered.per_unitindicates that the fixed amount (specified inunit_amountorunit_amount_decimal) will be charged per unit inquantity(for prices withusage_type=licensed), or per unit of total usage (for prices withusage_type=metered).tieredindicates that the unit pricing will be computed using a tiering strategy as defined using thetiersandtiers_modeattributes. - Currency
Options List<PriceCurrency Option> - Prices defined in each available currency option. Each key must be a three-letter ISO currency code and a supported currency.
- Custom
Unit List<PriceAmounts Custom Unit Amount> - When set, provides configuration for the amount to be adjusted by the customer during Checkout Sessions and Payment Links.
- Lookup
Key string - A lookup key used to retrieve prices dynamically from a static string. This may be up to 200 characters.
- Metadata Dictionary<string, string>
- 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.
- Nickname string
- A brief description of the price, hidden from customers.
- Product string
- The ID of the product this price is associated with.
- Product
Datas List<PriceProduct Data> - These fields can be used to create a new product that this price will belong to.
- Recurrings
List<Price
Recurring> - The recurring components of a price such as
intervalandusage_type. - Tax
Behavior string - 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 eitherinclusiveorexclusive, it cannot be changed. - Tiers
List<Price
Tier> - Each element represents a pricing tier. This parameter requires
billing_schemeto be set totiered. See also the documentation forbilling_scheme. - Tiers
Mode string - Defines if the tiering price should be
graduatedorvolumebased. Involume-based tiering, the maximum quantity within a period determines the per unit price. Ingraduatedtiering, pricing can change as the quantity grows. - Transfer
Lookup boolKey - If set to true, will atomically remove the lookup key from the existing price, and assign it to this price.
- Transform
Quantity PriceTransform Quantity - Apply a transformation to the reported usage or set quantity before computing the amount billed. Cannot be combined with
tiers. - Unit
Amount double - The unit amount in cents (or local equivalent) to be charged, represented as a whole integer if possible. Only set if
billing_scheme=per_unit. - Unit
Amount stringDecimal - The unit amount in cents (or local equivalent) to be charged, represented as a decimal string with at most 12 decimal places. Only set if
billing_scheme=per_unit.
- Currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- Active bool
- Whether the price can be used for new purchases.
- Billing
Scheme string - Describes how to compute the price per period. Either
per_unitortiered.per_unitindicates that the fixed amount (specified inunit_amountorunit_amount_decimal) will be charged per unit inquantity(for prices withusage_type=licensed), or per unit of total usage (for prices withusage_type=metered).tieredindicates that the unit pricing will be computed using a tiering strategy as defined using thetiersandtiers_modeattributes. - Currency
Options []PriceCurrency Option Args - Prices defined in each available currency option. Each key must be a three-letter ISO currency code and a supported currency.
- Custom
Unit []PriceAmounts Custom Unit Amount Args - When set, provides configuration for the amount to be adjusted by the customer during Checkout Sessions and Payment Links.
- Lookup
Key string - A lookup key used to retrieve prices dynamically from a static string. This may be up to 200 characters.
- Metadata map[string]string
- 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.
- Nickname string
- A brief description of the price, hidden from customers.
- Product string
- The ID of the product this price is associated with.
- Product
Datas []PriceProduct Data Args - These fields can be used to create a new product that this price will belong to.
- Recurrings
[]Price
Recurring Args - The recurring components of a price such as
intervalandusage_type. - Tax
Behavior string - 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 eitherinclusiveorexclusive, it cannot be changed. - Tiers
[]Price
Tier Args - Each element represents a pricing tier. This parameter requires
billing_schemeto be set totiered. See also the documentation forbilling_scheme. - Tiers
Mode string - Defines if the tiering price should be
graduatedorvolumebased. Involume-based tiering, the maximum quantity within a period determines the per unit price. Ingraduatedtiering, pricing can change as the quantity grows. - Transfer
Lookup boolKey - If set to true, will atomically remove the lookup key from the existing price, and assign it to this price.
- Transform
Quantity PriceTransform Quantity Args - Apply a transformation to the reported usage or set quantity before computing the amount billed. Cannot be combined with
tiers. - Unit
Amount float64 - The unit amount in cents (or local equivalent) to be charged, represented as a whole integer if possible. Only set if
billing_scheme=per_unit. - Unit
Amount stringDecimal - The unit amount in cents (or local equivalent) to be charged, represented as a decimal string with at most 12 decimal places. Only set if
billing_scheme=per_unit.
- currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- active bool
- Whether the price can be used for new purchases.
- billing_
scheme string - Describes how to compute the price per period. Either
per_unitortiered.per_unitindicates that the fixed amount (specified inunit_amountorunit_amount_decimal) will be charged per unit inquantity(for prices withusage_type=licensed), or per unit of total usage (for prices withusage_type=metered).tieredindicates that the unit pricing will be computed using a tiering strategy as defined using thetiersandtiers_modeattributes. - currency_
options list(object) - Prices defined in each available currency option. Each key must be a three-letter ISO currency code and a supported currency.
- custom_
unit_ list(object)amounts - When set, provides configuration for the amount to be adjusted by the customer during Checkout Sessions and Payment Links.
- lookup_
key string - A lookup key used to retrieve prices dynamically from a static string. This may be up to 200 characters.
- metadata map(string)
- 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.
- nickname string
- A brief description of the price, hidden from customers.
- product string
- The ID of the product this price is associated with.
- product_
datas list(object) - These fields can be used to create a new product that this price will belong to.
- recurrings list(object)
- The recurring components of a price such as
intervalandusage_type. - tax_
behavior string - 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 eitherinclusiveorexclusive, it cannot be changed. - tiers list(object)
- Each element represents a pricing tier. This parameter requires
billing_schemeto be set totiered. See also the documentation forbilling_scheme. - tiers_
mode string - Defines if the tiering price should be
graduatedorvolumebased. Involume-based tiering, the maximum quantity within a period determines the per unit price. Ingraduatedtiering, pricing can change as the quantity grows. - transfer_
lookup_ boolkey - If set to true, will atomically remove the lookup key from the existing price, and assign it to this price.
- transform_
quantity object - Apply a transformation to the reported usage or set quantity before computing the amount billed. Cannot be combined with
tiers. - unit_
amount number - The unit amount in cents (or local equivalent) to be charged, represented as a whole integer if possible. Only set if
billing_scheme=per_unit. - unit_
amount_ stringdecimal - The unit amount in cents (or local equivalent) to be charged, represented as a decimal string with at most 12 decimal places. Only set if
billing_scheme=per_unit.
- currency String
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- active Boolean
- Whether the price can be used for new purchases.
- billing
Scheme String - Describes how to compute the price per period. Either
per_unitortiered.per_unitindicates that the fixed amount (specified inunit_amountorunit_amount_decimal) will be charged per unit inquantity(for prices withusage_type=licensed), or per unit of total usage (for prices withusage_type=metered).tieredindicates that the unit pricing will be computed using a tiering strategy as defined using thetiersandtiers_modeattributes. - currency
Options List<PriceCurrency Option> - Prices defined in each available currency option. Each key must be a three-letter ISO currency code and a supported currency.
- custom
Unit List<PriceAmounts Custom Unit Amount> - When set, provides configuration for the amount to be adjusted by the customer during Checkout Sessions and Payment Links.
- lookup
Key String - A lookup key used to retrieve prices dynamically from a static string. This may be up to 200 characters.
- metadata Map<String,String>
- 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.
- nickname String
- A brief description of the price, hidden from customers.
- product String
- The ID of the product this price is associated with.
- product
Datas List<PriceProduct Data> - These fields can be used to create a new product that this price will belong to.
- recurrings
List<Price
Recurring> - The recurring components of a price such as
intervalandusage_type. - tax
Behavior String - 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 eitherinclusiveorexclusive, it cannot be changed. - tiers
List<Price
Tier> - Each element represents a pricing tier. This parameter requires
billing_schemeto be set totiered. See also the documentation forbilling_scheme. - tiers
Mode String - Defines if the tiering price should be
graduatedorvolumebased. Involume-based tiering, the maximum quantity within a period determines the per unit price. Ingraduatedtiering, pricing can change as the quantity grows. - transfer
Lookup BooleanKey - If set to true, will atomically remove the lookup key from the existing price, and assign it to this price.
- transform
Quantity PriceTransform Quantity - Apply a transformation to the reported usage or set quantity before computing the amount billed. Cannot be combined with
tiers. - unit
Amount Double - The unit amount in cents (or local equivalent) to be charged, represented as a whole integer if possible. Only set if
billing_scheme=per_unit. - unit
Amount StringDecimal - The unit amount in cents (or local equivalent) to be charged, represented as a decimal string with at most 12 decimal places. Only set if
billing_scheme=per_unit.
- currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- active boolean
- Whether the price can be used for new purchases.
- billing
Scheme string - Describes how to compute the price per period. Either
per_unitortiered.per_unitindicates that the fixed amount (specified inunit_amountorunit_amount_decimal) will be charged per unit inquantity(for prices withusage_type=licensed), or per unit of total usage (for prices withusage_type=metered).tieredindicates that the unit pricing will be computed using a tiering strategy as defined using thetiersandtiers_modeattributes. - currency
Options PriceCurrency Option[] - Prices defined in each available currency option. Each key must be a three-letter ISO currency code and a supported currency.
- custom
Unit PriceAmounts Custom Unit Amount[] - When set, provides configuration for the amount to be adjusted by the customer during Checkout Sessions and Payment Links.
- lookup
Key string - A lookup key used to retrieve prices dynamically from a static string. This may be up to 200 characters.
- metadata {[key: string]: string}
- 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.
- nickname string
- A brief description of the price, hidden from customers.
- product string
- The ID of the product this price is associated with.
- product
Datas PriceProduct Data[] - These fields can be used to create a new product that this price will belong to.
- recurrings
Price
Recurring[] - The recurring components of a price such as
intervalandusage_type. - tax
Behavior string - 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 eitherinclusiveorexclusive, it cannot be changed. - tiers
Price
Tier[] - Each element represents a pricing tier. This parameter requires
billing_schemeto be set totiered. See also the documentation forbilling_scheme. - tiers
Mode string - Defines if the tiering price should be
graduatedorvolumebased. Involume-based tiering, the maximum quantity within a period determines the per unit price. Ingraduatedtiering, pricing can change as the quantity grows. - transfer
Lookup booleanKey - If set to true, will atomically remove the lookup key from the existing price, and assign it to this price.
- transform
Quantity PriceTransform Quantity - Apply a transformation to the reported usage or set quantity before computing the amount billed. Cannot be combined with
tiers. - unit
Amount number - The unit amount in cents (or local equivalent) to be charged, represented as a whole integer if possible. Only set if
billing_scheme=per_unit. - unit
Amount stringDecimal - The unit amount in cents (or local equivalent) to be charged, represented as a decimal string with at most 12 decimal places. Only set if
billing_scheme=per_unit.
- currency str
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- active bool
- Whether the price can be used for new purchases.
- billing_
scheme str - Describes how to compute the price per period. Either
per_unitortiered.per_unitindicates that the fixed amount (specified inunit_amountorunit_amount_decimal) will be charged per unit inquantity(for prices withusage_type=licensed), or per unit of total usage (for prices withusage_type=metered).tieredindicates that the unit pricing will be computed using a tiering strategy as defined using thetiersandtiers_modeattributes. - currency_
options Sequence[PriceCurrency Option Args] - Prices defined in each available currency option. Each key must be a three-letter ISO currency code and a supported currency.
- custom_
unit_ Sequence[Priceamounts Custom Unit Amount Args] - When set, provides configuration for the amount to be adjusted by the customer during Checkout Sessions and Payment Links.
- lookup_
key str - A lookup key used to retrieve prices dynamically from a static string. This may be up to 200 characters.
- metadata Mapping[str, str]
- 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.
- nickname str
- A brief description of the price, hidden from customers.
- product str
- The ID of the product this price is associated with.
- product_
datas Sequence[PriceProduct Data Args] - These fields can be used to create a new product that this price will belong to.
- recurrings
Sequence[Price
Recurring Args] - The recurring components of a price such as
intervalandusage_type. - tax_
behavior str - 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 eitherinclusiveorexclusive, it cannot be changed. - tiers
Sequence[Price
Tier Args] - Each element represents a pricing tier. This parameter requires
billing_schemeto be set totiered. See also the documentation forbilling_scheme. - tiers_
mode str - Defines if the tiering price should be
graduatedorvolumebased. Involume-based tiering, the maximum quantity within a period determines the per unit price. Ingraduatedtiering, pricing can change as the quantity grows. - transfer_
lookup_ boolkey - If set to true, will atomically remove the lookup key from the existing price, and assign it to this price.
- transform_
quantity PriceTransform Quantity Args - Apply a transformation to the reported usage or set quantity before computing the amount billed. Cannot be combined with
tiers. - unit_
amount float - The unit amount in cents (or local equivalent) to be charged, represented as a whole integer if possible. Only set if
billing_scheme=per_unit. - unit_
amount_ strdecimal - The unit amount in cents (or local equivalent) to be charged, represented as a decimal string with at most 12 decimal places. Only set if
billing_scheme=per_unit.
- currency String
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- active Boolean
- Whether the price can be used for new purchases.
- billing
Scheme String - Describes how to compute the price per period. Either
per_unitortiered.per_unitindicates that the fixed amount (specified inunit_amountorunit_amount_decimal) will be charged per unit inquantity(for prices withusage_type=licensed), or per unit of total usage (for prices withusage_type=metered).tieredindicates that the unit pricing will be computed using a tiering strategy as defined using thetiersandtiers_modeattributes. - currency
Options List<Property Map> - Prices defined in each available currency option. Each key must be a three-letter ISO currency code and a supported currency.
- custom
Unit List<Property Map>Amounts - When set, provides configuration for the amount to be adjusted by the customer during Checkout Sessions and Payment Links.
- lookup
Key String - A lookup key used to retrieve prices dynamically from a static string. This may be up to 200 characters.
- metadata Map<String>
- 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.
- nickname String
- A brief description of the price, hidden from customers.
- product String
- The ID of the product this price is associated with.
- product
Datas List<Property Map> - These fields can be used to create a new product that this price will belong to.
- recurrings List<Property Map>
- The recurring components of a price such as
intervalandusage_type. - tax
Behavior String - 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 eitherinclusiveorexclusive, it cannot be changed. - tiers List<Property Map>
- Each element represents a pricing tier. This parameter requires
billing_schemeto be set totiered. See also the documentation forbilling_scheme. - tiers
Mode String - Defines if the tiering price should be
graduatedorvolumebased. Involume-based tiering, the maximum quantity within a period determines the per unit price. Ingraduatedtiering, pricing can change as the quantity grows. - transfer
Lookup BooleanKey - If set to true, will atomically remove the lookup key from the existing price, and assign it to this price.
- transform
Quantity Property Map - Apply a transformation to the reported usage or set quantity before computing the amount billed. Cannot be combined with
tiers. - unit
Amount Number - The unit amount in cents (or local equivalent) to be charged, represented as a whole integer if possible. Only set if
billing_scheme=per_unit. - unit
Amount StringDecimal - The unit amount in cents (or local equivalent) to be charged, represented as a decimal string with at most 12 decimal places. Only set if
billing_scheme=per_unit.
Outputs
All input properties are implicitly available as output properties. Additionally, the Price resource produces the following output properties:
- Created double
- Time at which the object was created. Measured in seconds since the Unix epoch.
- Id string
- The provider-assigned unique ID for this managed resource.
- Livemode bool
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - Object string
- String representing the object's type. Objects of the same type share the same value.
- Type string
- One of
one_timeorrecurringdepending on whether the price is for a one-time purchase or a recurring (subscription) purchase.
- Created float64
- Time at which the object was created. Measured in seconds since the Unix epoch.
- Id string
- The provider-assigned unique ID for this managed resource.
- Livemode bool
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - Object string
- String representing the object's type. Objects of the same type share the same value.
- Type string
- One of
one_timeorrecurringdepending on whether the price is for a one-time purchase or a recurring (subscription) purchase.
- created number
- Time at which the object was created. Measured in seconds since the Unix epoch.
- id string
- The provider-assigned unique ID for this managed resource.
- livemode bool
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - object string
- String representing the object's type. Objects of the same type share the same value.
- type string
- One of
one_timeorrecurringdepending on whether the price is for a one-time purchase or a recurring (subscription) purchase.
- created Double
- Time at which the object was created. Measured in seconds since the Unix epoch.
- id String
- The provider-assigned unique ID for this managed resource.
- livemode Boolean
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - object String
- String representing the object's type. Objects of the same type share the same value.
- type String
- One of
one_timeorrecurringdepending on whether the price is for a one-time purchase or a recurring (subscription) purchase.
- created number
- Time at which the object was created. Measured in seconds since the Unix epoch.
- id string
- The provider-assigned unique ID for this managed resource.
- livemode boolean
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - object string
- String representing the object's type. Objects of the same type share the same value.
- type string
- One of
one_timeorrecurringdepending on whether the price is for a one-time purchase or a recurring (subscription) purchase.
- created float
- Time at which the object was created. Measured in seconds since the Unix epoch.
- id str
- The provider-assigned unique ID for this managed resource.
- livemode bool
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - object str
- String representing the object's type. Objects of the same type share the same value.
- type str
- One of
one_timeorrecurringdepending on whether the price is for a one-time purchase or a recurring (subscription) purchase.
- created Number
- Time at which the object was created. Measured in seconds since the Unix epoch.
- id String
- The provider-assigned unique ID for this managed resource.
- livemode Boolean
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - object String
- String representing the object's type. Objects of the same type share the same value.
- type String
- One of
one_timeorrecurringdepending on whether the price is for a one-time purchase or a recurring (subscription) purchase.
Look up Existing Price Resource
Get an existing Price resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: PriceState, opts?: CustomResourceOptions): Price@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
active: Optional[bool] = None,
billing_scheme: Optional[str] = None,
created: Optional[float] = None,
currency: Optional[str] = None,
currency_options: Optional[Sequence[PriceCurrencyOptionArgs]] = None,
custom_unit_amounts: Optional[Sequence[PriceCustomUnitAmountArgs]] = None,
livemode: Optional[bool] = None,
lookup_key: Optional[str] = None,
metadata: Optional[Mapping[str, str]] = None,
nickname: Optional[str] = None,
object: Optional[str] = None,
product: Optional[str] = None,
product_datas: Optional[Sequence[PriceProductDataArgs]] = None,
recurrings: Optional[Sequence[PriceRecurringArgs]] = None,
tax_behavior: Optional[str] = None,
tiers: Optional[Sequence[PriceTierArgs]] = None,
tiers_mode: Optional[str] = None,
transfer_lookup_key: Optional[bool] = None,
transform_quantity: Optional[PriceTransformQuantityArgs] = None,
type: Optional[str] = None,
unit_amount: Optional[float] = None,
unit_amount_decimal: Optional[str] = None) -> Pricefunc GetPrice(ctx *Context, name string, id IDInput, state *PriceState, opts ...ResourceOption) (*Price, error)public static Price Get(string name, Input<string> id, PriceState? state, CustomResourceOptions? opts = null)public static Price get(String name, Output<String> id, PriceState state, CustomResourceOptions options)resources: _: type: stripe:Price get: id: ${id}import {
to = stripe_price.example
id = "${id}"
}
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Active bool
- Whether the price can be used for new purchases.
- Billing
Scheme string - Describes how to compute the price per period. Either
per_unitortiered.per_unitindicates that the fixed amount (specified inunit_amountorunit_amount_decimal) will be charged per unit inquantity(for prices withusage_type=licensed), or per unit of total usage (for prices withusage_type=metered).tieredindicates that the unit pricing will be computed using a tiering strategy as defined using thetiersandtiers_modeattributes. - Created double
- Time at which the object was created. Measured in seconds since the Unix epoch.
- Currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- Currency
Options List<PriceCurrency Option> - Prices defined in each available currency option. Each key must be a three-letter ISO currency code and a supported currency.
- Custom
Unit List<PriceAmounts Custom Unit Amount> - When set, provides configuration for the amount to be adjusted by the customer during Checkout Sessions and Payment Links.
- Livemode bool
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - Lookup
Key string - A lookup key used to retrieve prices dynamically from a static string. This may be up to 200 characters.
- Metadata Dictionary<string, string>
- 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.
- Nickname string
- A brief description of the price, hidden from customers.
- Object string
- String representing the object's type. Objects of the same type share the same value.
- Product string
- The ID of the product this price is associated with.
- Product
Datas List<PriceProduct Data> - These fields can be used to create a new product that this price will belong to.
- Recurrings
List<Price
Recurring> - The recurring components of a price such as
intervalandusage_type. - Tax
Behavior string - 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 eitherinclusiveorexclusive, it cannot be changed. - Tiers
List<Price
Tier> - Each element represents a pricing tier. This parameter requires
billing_schemeto be set totiered. See also the documentation forbilling_scheme. - Tiers
Mode string - Defines if the tiering price should be
graduatedorvolumebased. Involume-based tiering, the maximum quantity within a period determines the per unit price. Ingraduatedtiering, pricing can change as the quantity grows. - Transfer
Lookup boolKey - If set to true, will atomically remove the lookup key from the existing price, and assign it to this price.
- Transform
Quantity PriceTransform Quantity - Apply a transformation to the reported usage or set quantity before computing the amount billed. Cannot be combined with
tiers. - Type string
- One of
one_timeorrecurringdepending on whether the price is for a one-time purchase or a recurring (subscription) purchase. - Unit
Amount double - The unit amount in cents (or local equivalent) to be charged, represented as a whole integer if possible. Only set if
billing_scheme=per_unit. - Unit
Amount stringDecimal - The unit amount in cents (or local equivalent) to be charged, represented as a decimal string with at most 12 decimal places. Only set if
billing_scheme=per_unit.
- Active bool
- Whether the price can be used for new purchases.
- Billing
Scheme string - Describes how to compute the price per period. Either
per_unitortiered.per_unitindicates that the fixed amount (specified inunit_amountorunit_amount_decimal) will be charged per unit inquantity(for prices withusage_type=licensed), or per unit of total usage (for prices withusage_type=metered).tieredindicates that the unit pricing will be computed using a tiering strategy as defined using thetiersandtiers_modeattributes. - Created float64
- Time at which the object was created. Measured in seconds since the Unix epoch.
- Currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- Currency
Options []PriceCurrency Option Args - Prices defined in each available currency option. Each key must be a three-letter ISO currency code and a supported currency.
- Custom
Unit []PriceAmounts Custom Unit Amount Args - When set, provides configuration for the amount to be adjusted by the customer during Checkout Sessions and Payment Links.
- Livemode bool
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - Lookup
Key string - A lookup key used to retrieve prices dynamically from a static string. This may be up to 200 characters.
- Metadata map[string]string
- 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.
- Nickname string
- A brief description of the price, hidden from customers.
- Object string
- String representing the object's type. Objects of the same type share the same value.
- Product string
- The ID of the product this price is associated with.
- Product
Datas []PriceProduct Data Args - These fields can be used to create a new product that this price will belong to.
- Recurrings
[]Price
Recurring Args - The recurring components of a price such as
intervalandusage_type. - Tax
Behavior string - 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 eitherinclusiveorexclusive, it cannot be changed. - Tiers
[]Price
Tier Args - Each element represents a pricing tier. This parameter requires
billing_schemeto be set totiered. See also the documentation forbilling_scheme. - Tiers
Mode string - Defines if the tiering price should be
graduatedorvolumebased. Involume-based tiering, the maximum quantity within a period determines the per unit price. Ingraduatedtiering, pricing can change as the quantity grows. - Transfer
Lookup boolKey - If set to true, will atomically remove the lookup key from the existing price, and assign it to this price.
- Transform
Quantity PriceTransform Quantity Args - Apply a transformation to the reported usage or set quantity before computing the amount billed. Cannot be combined with
tiers. - Type string
- One of
one_timeorrecurringdepending on whether the price is for a one-time purchase or a recurring (subscription) purchase. - Unit
Amount float64 - The unit amount in cents (or local equivalent) to be charged, represented as a whole integer if possible. Only set if
billing_scheme=per_unit. - Unit
Amount stringDecimal - The unit amount in cents (or local equivalent) to be charged, represented as a decimal string with at most 12 decimal places. Only set if
billing_scheme=per_unit.
- active bool
- Whether the price can be used for new purchases.
- billing_
scheme string - Describes how to compute the price per period. Either
per_unitortiered.per_unitindicates that the fixed amount (specified inunit_amountorunit_amount_decimal) will be charged per unit inquantity(for prices withusage_type=licensed), or per unit of total usage (for prices withusage_type=metered).tieredindicates that the unit pricing will be computed using a tiering strategy as defined using thetiersandtiers_modeattributes. - created number
- Time at which the object was created. Measured in seconds since the Unix epoch.
- currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- currency_
options list(object) - Prices defined in each available currency option. Each key must be a three-letter ISO currency code and a supported currency.
- custom_
unit_ list(object)amounts - When set, provides configuration for the amount to be adjusted by the customer during Checkout Sessions and Payment Links.
- livemode bool
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - lookup_
key string - A lookup key used to retrieve prices dynamically from a static string. This may be up to 200 characters.
- metadata map(string)
- 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.
- nickname string
- A brief description of the price, hidden from customers.
- object string
- String representing the object's type. Objects of the same type share the same value.
- product string
- The ID of the product this price is associated with.
- product_
datas list(object) - These fields can be used to create a new product that this price will belong to.
- recurrings list(object)
- The recurring components of a price such as
intervalandusage_type. - tax_
behavior string - 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 eitherinclusiveorexclusive, it cannot be changed. - tiers list(object)
- Each element represents a pricing tier. This parameter requires
billing_schemeto be set totiered. See also the documentation forbilling_scheme. - tiers_
mode string - Defines if the tiering price should be
graduatedorvolumebased. Involume-based tiering, the maximum quantity within a period determines the per unit price. Ingraduatedtiering, pricing can change as the quantity grows. - transfer_
lookup_ boolkey - If set to true, will atomically remove the lookup key from the existing price, and assign it to this price.
- transform_
quantity object - Apply a transformation to the reported usage or set quantity before computing the amount billed. Cannot be combined with
tiers. - type string
- One of
one_timeorrecurringdepending on whether the price is for a one-time purchase or a recurring (subscription) purchase. - unit_
amount number - The unit amount in cents (or local equivalent) to be charged, represented as a whole integer if possible. Only set if
billing_scheme=per_unit. - unit_
amount_ stringdecimal - The unit amount in cents (or local equivalent) to be charged, represented as a decimal string with at most 12 decimal places. Only set if
billing_scheme=per_unit.
- active Boolean
- Whether the price can be used for new purchases.
- billing
Scheme String - Describes how to compute the price per period. Either
per_unitortiered.per_unitindicates that the fixed amount (specified inunit_amountorunit_amount_decimal) will be charged per unit inquantity(for prices withusage_type=licensed), or per unit of total usage (for prices withusage_type=metered).tieredindicates that the unit pricing will be computed using a tiering strategy as defined using thetiersandtiers_modeattributes. - created Double
- Time at which the object was created. Measured in seconds since the Unix epoch.
- currency String
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- currency
Options List<PriceCurrency Option> - Prices defined in each available currency option. Each key must be a three-letter ISO currency code and a supported currency.
- custom
Unit List<PriceAmounts Custom Unit Amount> - When set, provides configuration for the amount to be adjusted by the customer during Checkout Sessions and Payment Links.
- livemode Boolean
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - lookup
Key String - A lookup key used to retrieve prices dynamically from a static string. This may be up to 200 characters.
- metadata Map<String,String>
- 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.
- nickname String
- A brief description of the price, hidden from customers.
- object String
- String representing the object's type. Objects of the same type share the same value.
- product String
- The ID of the product this price is associated with.
- product
Datas List<PriceProduct Data> - These fields can be used to create a new product that this price will belong to.
- recurrings
List<Price
Recurring> - The recurring components of a price such as
intervalandusage_type. - tax
Behavior String - 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 eitherinclusiveorexclusive, it cannot be changed. - tiers
List<Price
Tier> - Each element represents a pricing tier. This parameter requires
billing_schemeto be set totiered. See also the documentation forbilling_scheme. - tiers
Mode String - Defines if the tiering price should be
graduatedorvolumebased. Involume-based tiering, the maximum quantity within a period determines the per unit price. Ingraduatedtiering, pricing can change as the quantity grows. - transfer
Lookup BooleanKey - If set to true, will atomically remove the lookup key from the existing price, and assign it to this price.
- transform
Quantity PriceTransform Quantity - Apply a transformation to the reported usage or set quantity before computing the amount billed. Cannot be combined with
tiers. - type String
- One of
one_timeorrecurringdepending on whether the price is for a one-time purchase or a recurring (subscription) purchase. - unit
Amount Double - The unit amount in cents (or local equivalent) to be charged, represented as a whole integer if possible. Only set if
billing_scheme=per_unit. - unit
Amount StringDecimal - The unit amount in cents (or local equivalent) to be charged, represented as a decimal string with at most 12 decimal places. Only set if
billing_scheme=per_unit.
- active boolean
- Whether the price can be used for new purchases.
- billing
Scheme string - Describes how to compute the price per period. Either
per_unitortiered.per_unitindicates that the fixed amount (specified inunit_amountorunit_amount_decimal) will be charged per unit inquantity(for prices withusage_type=licensed), or per unit of total usage (for prices withusage_type=metered).tieredindicates that the unit pricing will be computed using a tiering strategy as defined using thetiersandtiers_modeattributes. - created number
- Time at which the object was created. Measured in seconds since the Unix epoch.
- currency string
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- currency
Options PriceCurrency Option[] - Prices defined in each available currency option. Each key must be a three-letter ISO currency code and a supported currency.
- custom
Unit PriceAmounts Custom Unit Amount[] - When set, provides configuration for the amount to be adjusted by the customer during Checkout Sessions and Payment Links.
- livemode boolean
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - lookup
Key string - A lookup key used to retrieve prices dynamically from a static string. This may be up to 200 characters.
- metadata {[key: string]: string}
- 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.
- nickname string
- A brief description of the price, hidden from customers.
- object string
- String representing the object's type. Objects of the same type share the same value.
- product string
- The ID of the product this price is associated with.
- product
Datas PriceProduct Data[] - These fields can be used to create a new product that this price will belong to.
- recurrings
Price
Recurring[] - The recurring components of a price such as
intervalandusage_type. - tax
Behavior string - 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 eitherinclusiveorexclusive, it cannot be changed. - tiers
Price
Tier[] - Each element represents a pricing tier. This parameter requires
billing_schemeto be set totiered. See also the documentation forbilling_scheme. - tiers
Mode string - Defines if the tiering price should be
graduatedorvolumebased. Involume-based tiering, the maximum quantity within a period determines the per unit price. Ingraduatedtiering, pricing can change as the quantity grows. - transfer
Lookup booleanKey - If set to true, will atomically remove the lookup key from the existing price, and assign it to this price.
- transform
Quantity PriceTransform Quantity - Apply a transformation to the reported usage or set quantity before computing the amount billed. Cannot be combined with
tiers. - type string
- One of
one_timeorrecurringdepending on whether the price is for a one-time purchase or a recurring (subscription) purchase. - unit
Amount number - The unit amount in cents (or local equivalent) to be charged, represented as a whole integer if possible. Only set if
billing_scheme=per_unit. - unit
Amount stringDecimal - The unit amount in cents (or local equivalent) to be charged, represented as a decimal string with at most 12 decimal places. Only set if
billing_scheme=per_unit.
- active bool
- Whether the price can be used for new purchases.
- billing_
scheme str - Describes how to compute the price per period. Either
per_unitortiered.per_unitindicates that the fixed amount (specified inunit_amountorunit_amount_decimal) will be charged per unit inquantity(for prices withusage_type=licensed), or per unit of total usage (for prices withusage_type=metered).tieredindicates that the unit pricing will be computed using a tiering strategy as defined using thetiersandtiers_modeattributes. - created float
- Time at which the object was created. Measured in seconds since the Unix epoch.
- currency str
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- currency_
options Sequence[PriceCurrency Option Args] - Prices defined in each available currency option. Each key must be a three-letter ISO currency code and a supported currency.
- custom_
unit_ Sequence[Priceamounts Custom Unit Amount Args] - When set, provides configuration for the amount to be adjusted by the customer during Checkout Sessions and Payment Links.
- livemode bool
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - lookup_
key str - A lookup key used to retrieve prices dynamically from a static string. This may be up to 200 characters.
- metadata Mapping[str, str]
- 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.
- nickname str
- A brief description of the price, hidden from customers.
- object str
- String representing the object's type. Objects of the same type share the same value.
- product str
- The ID of the product this price is associated with.
- product_
datas Sequence[PriceProduct Data Args] - These fields can be used to create a new product that this price will belong to.
- recurrings
Sequence[Price
Recurring Args] - The recurring components of a price such as
intervalandusage_type. - tax_
behavior str - 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 eitherinclusiveorexclusive, it cannot be changed. - tiers
Sequence[Price
Tier Args] - Each element represents a pricing tier. This parameter requires
billing_schemeto be set totiered. See also the documentation forbilling_scheme. - tiers_
mode str - Defines if the tiering price should be
graduatedorvolumebased. Involume-based tiering, the maximum quantity within a period determines the per unit price. Ingraduatedtiering, pricing can change as the quantity grows. - transfer_
lookup_ boolkey - If set to true, will atomically remove the lookup key from the existing price, and assign it to this price.
- transform_
quantity PriceTransform Quantity Args - Apply a transformation to the reported usage or set quantity before computing the amount billed. Cannot be combined with
tiers. - type str
- One of
one_timeorrecurringdepending on whether the price is for a one-time purchase or a recurring (subscription) purchase. - unit_
amount float - The unit amount in cents (or local equivalent) to be charged, represented as a whole integer if possible. Only set if
billing_scheme=per_unit. - unit_
amount_ strdecimal - The unit amount in cents (or local equivalent) to be charged, represented as a decimal string with at most 12 decimal places. Only set if
billing_scheme=per_unit.
- active Boolean
- Whether the price can be used for new purchases.
- billing
Scheme String - Describes how to compute the price per period. Either
per_unitortiered.per_unitindicates that the fixed amount (specified inunit_amountorunit_amount_decimal) will be charged per unit inquantity(for prices withusage_type=licensed), or per unit of total usage (for prices withusage_type=metered).tieredindicates that the unit pricing will be computed using a tiering strategy as defined using thetiersandtiers_modeattributes. - created Number
- Time at which the object was created. Measured in seconds since the Unix epoch.
- currency String
- Three-letter ISO currency code, in lowercase. Must be a supported currency.
- currency
Options List<Property Map> - Prices defined in each available currency option. Each key must be a three-letter ISO currency code and a supported currency.
- custom
Unit List<Property Map>Amounts - When set, provides configuration for the amount to be adjusted by the customer during Checkout Sessions and Payment Links.
- livemode Boolean
- If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - lookup
Key String - A lookup key used to retrieve prices dynamically from a static string. This may be up to 200 characters.
- metadata Map<String>
- 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.
- nickname String
- A brief description of the price, hidden from customers.
- object String
- String representing the object's type. Objects of the same type share the same value.
- product String
- The ID of the product this price is associated with.
- product
Datas List<Property Map> - These fields can be used to create a new product that this price will belong to.
- recurrings List<Property Map>
- The recurring components of a price such as
intervalandusage_type. - tax
Behavior String - 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 eitherinclusiveorexclusive, it cannot be changed. - tiers List<Property Map>
- Each element represents a pricing tier. This parameter requires
billing_schemeto be set totiered. See also the documentation forbilling_scheme. - tiers
Mode String - Defines if the tiering price should be
graduatedorvolumebased. Involume-based tiering, the maximum quantity within a period determines the per unit price. Ingraduatedtiering, pricing can change as the quantity grows. - transfer
Lookup BooleanKey - If set to true, will atomically remove the lookup key from the existing price, and assign it to this price.
- transform
Quantity Property Map - Apply a transformation to the reported usage or set quantity before computing the amount billed. Cannot be combined with
tiers. - type String
- One of
one_timeorrecurringdepending on whether the price is for a one-time purchase or a recurring (subscription) purchase. - unit
Amount Number - The unit amount in cents (or local equivalent) to be charged, represented as a whole integer if possible. Only set if
billing_scheme=per_unit. - unit
Amount StringDecimal - The unit amount in cents (or local equivalent) to be charged, represented as a decimal string with at most 12 decimal places. Only set if
billing_scheme=per_unit.
Supporting Types
PriceCurrencyOption, PriceCurrencyOptionArgs
- Key string
- Key for this entry.
- Custom
Unit List<PriceAmounts Currency Option Custom Unit Amount> - When set, provides configuration for the amount to be adjusted by the customer during Checkout Sessions and Payment Links.
- Tax
Behavior string - 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 eitherinclusiveorexclusive, it cannot be changed. - Tiers
List<Price
Currency Option Tier> - Each element represents a pricing tier. This parameter requires
billing_schemeto be set totiered. See also the documentation forbilling_scheme. - Unit
Amount double - The unit amount in cents (or local equivalent) to be charged, represented as a whole integer if possible. Only set if
billing_scheme=per_unit. - Unit
Amount stringDecimal - The unit amount in cents (or local equivalent) to be charged, represented as a decimal string with at most 12 decimal places. Only set if
billing_scheme=per_unit.
- Key string
- Key for this entry.
- Custom
Unit []PriceAmounts Currency Option Custom Unit Amount - When set, provides configuration for the amount to be adjusted by the customer during Checkout Sessions and Payment Links.
- Tax
Behavior string - 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 eitherinclusiveorexclusive, it cannot be changed. - Tiers
[]Price
Currency Option Tier - Each element represents a pricing tier. This parameter requires
billing_schemeto be set totiered. See also the documentation forbilling_scheme. - Unit
Amount float64 - The unit amount in cents (or local equivalent) to be charged, represented as a whole integer if possible. Only set if
billing_scheme=per_unit. - Unit
Amount stringDecimal - The unit amount in cents (or local equivalent) to be charged, represented as a decimal string with at most 12 decimal places. Only set if
billing_scheme=per_unit.
- key string
- Key for this entry.
- custom_
unit_ list(object)amounts - When set, provides configuration for the amount to be adjusted by the customer during Checkout Sessions and Payment Links.
- tax_
behavior string - 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 eitherinclusiveorexclusive, it cannot be changed. - tiers list(object)
- Each element represents a pricing tier. This parameter requires
billing_schemeto be set totiered. See also the documentation forbilling_scheme. - unit_
amount number - The unit amount in cents (or local equivalent) to be charged, represented as a whole integer if possible. Only set if
billing_scheme=per_unit. - unit_
amount_ stringdecimal - The unit amount in cents (or local equivalent) to be charged, represented as a decimal string with at most 12 decimal places. Only set if
billing_scheme=per_unit.
- key String
- Key for this entry.
- custom
Unit List<PriceAmounts Currency Option Custom Unit Amount> - When set, provides configuration for the amount to be adjusted by the customer during Checkout Sessions and Payment Links.
- tax
Behavior String - 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 eitherinclusiveorexclusive, it cannot be changed. - tiers
List<Price
Currency Option Tier> - Each element represents a pricing tier. This parameter requires
billing_schemeto be set totiered. See also the documentation forbilling_scheme. - unit
Amount Double - The unit amount in cents (or local equivalent) to be charged, represented as a whole integer if possible. Only set if
billing_scheme=per_unit. - unit
Amount StringDecimal - The unit amount in cents (or local equivalent) to be charged, represented as a decimal string with at most 12 decimal places. Only set if
billing_scheme=per_unit.
- key string
- Key for this entry.
- custom
Unit PriceAmounts Currency Option Custom Unit Amount[] - When set, provides configuration for the amount to be adjusted by the customer during Checkout Sessions and Payment Links.
- tax
Behavior string - 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 eitherinclusiveorexclusive, it cannot be changed. - tiers
Price
Currency Option Tier[] - Each element represents a pricing tier. This parameter requires
billing_schemeto be set totiered. See also the documentation forbilling_scheme. - unit
Amount number - The unit amount in cents (or local equivalent) to be charged, represented as a whole integer if possible. Only set if
billing_scheme=per_unit. - unit
Amount stringDecimal - The unit amount in cents (or local equivalent) to be charged, represented as a decimal string with at most 12 decimal places. Only set if
billing_scheme=per_unit.
- key str
- Key for this entry.
- custom_
unit_ Sequence[Priceamounts Currency Option Custom Unit Amount] - When set, provides configuration for the amount to be adjusted by the customer during Checkout Sessions and Payment Links.
- tax_
behavior str - 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 eitherinclusiveorexclusive, it cannot be changed. - tiers
Sequence[Price
Currency Option Tier] - Each element represents a pricing tier. This parameter requires
billing_schemeto be set totiered. See also the documentation forbilling_scheme. - unit_
amount float - The unit amount in cents (or local equivalent) to be charged, represented as a whole integer if possible. Only set if
billing_scheme=per_unit. - unit_
amount_ strdecimal - The unit amount in cents (or local equivalent) to be charged, represented as a decimal string with at most 12 decimal places. Only set if
billing_scheme=per_unit.
- key String
- Key for this entry.
- custom
Unit List<Property Map>Amounts - When set, provides configuration for the amount to be adjusted by the customer during Checkout Sessions and Payment Links.
- tax
Behavior String - 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 eitherinclusiveorexclusive, it cannot be changed. - tiers List<Property Map>
- Each element represents a pricing tier. This parameter requires
billing_schemeto be set totiered. See also the documentation forbilling_scheme. - unit
Amount Number - The unit amount in cents (or local equivalent) to be charged, represented as a whole integer if possible. Only set if
billing_scheme=per_unit. - unit
Amount StringDecimal - The unit amount in cents (or local equivalent) to be charged, represented as a decimal string with at most 12 decimal places. Only set if
billing_scheme=per_unit.
PriceCurrencyOptionCustomUnitAmount, PriceCurrencyOptionCustomUnitAmountArgs
- Enabled bool
- Pass in
trueto enablecustom_unit_amount, otherwise omitcustom_unit_amount. - Maximum double
- The maximum unit amount the customer can specify for this item.
- Minimum double
- The minimum unit amount the customer can specify for this item. Must be at least the minimum charge amount.
- Preset double
- The starting unit amount which can be updated by the customer.
- Enabled bool
- Pass in
trueto enablecustom_unit_amount, otherwise omitcustom_unit_amount. - Maximum float64
- The maximum unit amount the customer can specify for this item.
- Minimum float64
- The minimum unit amount the customer can specify for this item. Must be at least the minimum charge amount.
- Preset float64
- The starting unit amount which can be updated by the customer.
- enabled bool
- Pass in
trueto enablecustom_unit_amount, otherwise omitcustom_unit_amount. - maximum number
- The maximum unit amount the customer can specify for this item.
- minimum number
- The minimum unit amount the customer can specify for this item. Must be at least the minimum charge amount.
- preset number
- The starting unit amount which can be updated by the customer.
- enabled Boolean
- Pass in
trueto enablecustom_unit_amount, otherwise omitcustom_unit_amount. - maximum Double
- The maximum unit amount the customer can specify for this item.
- minimum Double
- The minimum unit amount the customer can specify for this item. Must be at least the minimum charge amount.
- preset Double
- The starting unit amount which can be updated by the customer.
- enabled boolean
- Pass in
trueto enablecustom_unit_amount, otherwise omitcustom_unit_amount. - maximum number
- The maximum unit amount the customer can specify for this item.
- minimum number
- The minimum unit amount the customer can specify for this item. Must be at least the minimum charge amount.
- preset number
- The starting unit amount which can be updated by the customer.
- enabled bool
- Pass in
trueto enablecustom_unit_amount, otherwise omitcustom_unit_amount. - maximum float
- The maximum unit amount the customer can specify for this item.
- minimum float
- The minimum unit amount the customer can specify for this item. Must be at least the minimum charge amount.
- preset float
- The starting unit amount which can be updated by the customer.
- enabled Boolean
- Pass in
trueto enablecustom_unit_amount, otherwise omitcustom_unit_amount. - maximum Number
- The maximum unit amount the customer can specify for this item.
- minimum Number
- The minimum unit amount the customer can specify for this item. Must be at least the minimum charge amount.
- preset Number
- The starting unit amount which can be updated by the customer.
PriceCurrencyOptionTier, PriceCurrencyOptionTierArgs
- Up
To string - Up to and including to this quantity will be contained in the tier.
- Flat
Amount double - Price for the entire tier.
- Flat
Amount stringDecimal - Same as
flat_amount, but contains a decimal value with at most 12 decimal places. - Unit
Amount double - Per unit price for units relevant to the tier.
- Unit
Amount stringDecimal - Same as
unit_amount, but contains a decimal value with at most 12 decimal places.
- Up
To string - Up to and including to this quantity will be contained in the tier.
- Flat
Amount float64 - Price for the entire tier.
- Flat
Amount stringDecimal - Same as
flat_amount, but contains a decimal value with at most 12 decimal places. - Unit
Amount float64 - Per unit price for units relevant to the tier.
- Unit
Amount stringDecimal - Same as
unit_amount, but contains a decimal value with at most 12 decimal places.
- up_
to string - Up to and including to this quantity will be contained in the tier.
- flat_
amount number - Price for the entire tier.
- flat_
amount_ stringdecimal - Same as
flat_amount, but contains a decimal value with at most 12 decimal places. - unit_
amount number - Per unit price for units relevant to the tier.
- unit_
amount_ stringdecimal - Same as
unit_amount, but contains a decimal value with at most 12 decimal places.
- up
To String - Up to and including to this quantity will be contained in the tier.
- flat
Amount Double - Price for the entire tier.
- flat
Amount StringDecimal - Same as
flat_amount, but contains a decimal value with at most 12 decimal places. - unit
Amount Double - Per unit price for units relevant to the tier.
- unit
Amount StringDecimal - Same as
unit_amount, but contains a decimal value with at most 12 decimal places.
- up
To string - Up to and including to this quantity will be contained in the tier.
- flat
Amount number - Price for the entire tier.
- flat
Amount stringDecimal - Same as
flat_amount, but contains a decimal value with at most 12 decimal places. - unit
Amount number - Per unit price for units relevant to the tier.
- unit
Amount stringDecimal - Same as
unit_amount, but contains a decimal value with at most 12 decimal places.
- up_
to str - Up to and including to this quantity will be contained in the tier.
- flat_
amount float - Price for the entire tier.
- flat_
amount_ strdecimal - Same as
flat_amount, but contains a decimal value with at most 12 decimal places. - unit_
amount float - Per unit price for units relevant to the tier.
- unit_
amount_ strdecimal - Same as
unit_amount, but contains a decimal value with at most 12 decimal places.
- up
To String - Up to and including to this quantity will be contained in the tier.
- flat
Amount Number - Price for the entire tier.
- flat
Amount StringDecimal - Same as
flat_amount, but contains a decimal value with at most 12 decimal places. - unit
Amount Number - Per unit price for units relevant to the tier.
- unit
Amount StringDecimal - Same as
unit_amount, but contains a decimal value with at most 12 decimal places.
PriceCustomUnitAmount, PriceCustomUnitAmountArgs
- Enabled bool
- Pass in
trueto enablecustom_unit_amount, otherwise omitcustom_unit_amount. - Maximum double
- The maximum unit amount the customer can specify for this item.
- Minimum double
- The minimum unit amount the customer can specify for this item. Must be at least the minimum charge amount.
- Preset double
- The starting unit amount which can be updated by the customer.
- Enabled bool
- Pass in
trueto enablecustom_unit_amount, otherwise omitcustom_unit_amount. - Maximum float64
- The maximum unit amount the customer can specify for this item.
- Minimum float64
- The minimum unit amount the customer can specify for this item. Must be at least the minimum charge amount.
- Preset float64
- The starting unit amount which can be updated by the customer.
- enabled bool
- Pass in
trueto enablecustom_unit_amount, otherwise omitcustom_unit_amount. - maximum number
- The maximum unit amount the customer can specify for this item.
- minimum number
- The minimum unit amount the customer can specify for this item. Must be at least the minimum charge amount.
- preset number
- The starting unit amount which can be updated by the customer.
- enabled Boolean
- Pass in
trueto enablecustom_unit_amount, otherwise omitcustom_unit_amount. - maximum Double
- The maximum unit amount the customer can specify for this item.
- minimum Double
- The minimum unit amount the customer can specify for this item. Must be at least the minimum charge amount.
- preset Double
- The starting unit amount which can be updated by the customer.
- enabled boolean
- Pass in
trueto enablecustom_unit_amount, otherwise omitcustom_unit_amount. - maximum number
- The maximum unit amount the customer can specify for this item.
- minimum number
- The minimum unit amount the customer can specify for this item. Must be at least the minimum charge amount.
- preset number
- The starting unit amount which can be updated by the customer.
- enabled bool
- Pass in
trueto enablecustom_unit_amount, otherwise omitcustom_unit_amount. - maximum float
- The maximum unit amount the customer can specify for this item.
- minimum float
- The minimum unit amount the customer can specify for this item. Must be at least the minimum charge amount.
- preset float
- The starting unit amount which can be updated by the customer.
- enabled Boolean
- Pass in
trueto enablecustom_unit_amount, otherwise omitcustom_unit_amount. - maximum Number
- The maximum unit amount the customer can specify for this item.
- minimum Number
- The minimum unit amount the customer can specify for this item. Must be at least the minimum charge amount.
- preset Number
- The starting unit amount which can be updated by the customer.
PriceProductData, PriceProductDataArgs
- Name string
- The product's name, meant to be displayable to the customer.
- Active bool
- Whether the product is currently available for purchase. Defaults to
true. - Id string
- The identifier for the product. Must be unique. If not provided, an identifier will be randomly generated.
- Metadata Dictionary<string, string>
- 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to
metadata. - Statement
Descriptor string - An arbitrary string to be displayed on your customer's credit card or bank statement. While most banks display this information consistently, some may display it incorrectly or not at all.
- Tax
Code string - A tax code ID.
- Unit
Label string - A label that represents units of this product. When set, this will be included in customers' receipts, invoices, Checkout, and the customer portal.
- Name string
- The product's name, meant to be displayable to the customer.
- Active bool
- Whether the product is currently available for purchase. Defaults to
true. - Id string
- The identifier for the product. Must be unique. If not provided, an identifier will be randomly generated.
- Metadata map[string]string
- 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to
metadata. - Statement
Descriptor string - An arbitrary string to be displayed on your customer's credit card or bank statement. While most banks display this information consistently, some may display it incorrectly or not at all.
- Tax
Code string - A tax code ID.
- Unit
Label string - A label that represents units of this product. When set, this will be included in customers' receipts, invoices, Checkout, and the customer portal.
- name string
- The product's name, meant to be displayable to the customer.
- active bool
- Whether the product is currently available for purchase. Defaults to
true. - id string
- The identifier for the product. Must be unique. If not provided, an identifier will be randomly generated.
- metadata map(string)
- 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to
metadata. - statement_
descriptor string - An arbitrary string to be displayed on your customer's credit card or bank statement. While most banks display this information consistently, some may display it incorrectly or not at all.
- tax_
code string - A tax code ID.
- unit_
label string - A label that represents units of this product. When set, this will be included in customers' receipts, invoices, Checkout, and the customer portal.
- name String
- The product's name, meant to be displayable to the customer.
- active Boolean
- Whether the product is currently available for purchase. Defaults to
true. - id String
- The identifier for the product. Must be unique. If not provided, an identifier will be randomly generated.
- metadata Map<String,String>
- 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to
metadata. - statement
Descriptor String - An arbitrary string to be displayed on your customer's credit card or bank statement. While most banks display this information consistently, some may display it incorrectly or not at all.
- tax
Code String - A tax code ID.
- unit
Label String - A label that represents units of this product. When set, this will be included in customers' receipts, invoices, Checkout, and the customer portal.
- name string
- The product's name, meant to be displayable to the customer.
- active boolean
- Whether the product is currently available for purchase. Defaults to
true. - id string
- The identifier for the product. Must be unique. If not provided, an identifier will be randomly generated.
- metadata {[key: string]: string}
- 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to
metadata. - statement
Descriptor string - An arbitrary string to be displayed on your customer's credit card or bank statement. While most banks display this information consistently, some may display it incorrectly or not at all.
- tax
Code string - A tax code ID.
- unit
Label string - A label that represents units of this product. When set, this will be included in customers' receipts, invoices, Checkout, and the customer portal.
- name str
- The product's name, meant to be displayable to the customer.
- active bool
- Whether the product is currently available for purchase. Defaults to
true. - id str
- The identifier for the product. Must be unique. If not provided, an identifier will be randomly generated.
- metadata Mapping[str, str]
- 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to
metadata. - statement_
descriptor str - An arbitrary string to be displayed on your customer's credit card or bank statement. While most banks display this information consistently, some may display it incorrectly or not at all.
- tax_
code str - A tax code ID.
- unit_
label str - A label that represents units of this product. When set, this will be included in customers' receipts, invoices, Checkout, and the customer portal.
- name String
- The product's name, meant to be displayable to the customer.
- active Boolean
- Whether the product is currently available for purchase. Defaults to
true. - id String
- The identifier for the product. Must be unique. If not provided, an identifier will be randomly generated.
- metadata Map<String>
- 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to
metadata. - statement
Descriptor String - An arbitrary string to be displayed on your customer's credit card or bank statement. While most banks display this information consistently, some may display it incorrectly or not at all.
- tax
Code String - A tax code ID.
- unit
Label String - A label that represents units of this product. When set, this will be included in customers' receipts, invoices, Checkout, and the customer portal.
PriceRecurring, PriceRecurringArgs
- Interval string
- The frequency at which a subscription is billed. One of
day,week,monthoryear. - Interval
Count double - The number of intervals (specified in the
intervalattribute) between subscription billings. For example,interval=monthandinterval_count=3bills every 3 months. - Meter string
- The meter tracking the usage of a metered price
- Trial
Period doubleDays - Default number of trial days when subscribing a customer to this price using
trial_from_plan=true. - Usage
Type string - Configures how the quantity per period should be determined. Can be either
meteredorlicensed.licensedautomatically bills thequantityset when adding it to a subscription.meteredaggregates the total usage based on usage records. Defaults tolicensed.
- Interval string
- The frequency at which a subscription is billed. One of
day,week,monthoryear. - Interval
Count float64 - The number of intervals (specified in the
intervalattribute) between subscription billings. For example,interval=monthandinterval_count=3bills every 3 months. - Meter string
- The meter tracking the usage of a metered price
- Trial
Period float64Days - Default number of trial days when subscribing a customer to this price using
trial_from_plan=true. - Usage
Type string - Configures how the quantity per period should be determined. Can be either
meteredorlicensed.licensedautomatically bills thequantityset when adding it to a subscription.meteredaggregates the total usage based on usage records. Defaults tolicensed.
- interval string
- The frequency at which a subscription is billed. One of
day,week,monthoryear. - interval_
count number - The number of intervals (specified in the
intervalattribute) between subscription billings. For example,interval=monthandinterval_count=3bills every 3 months. - meter string
- The meter tracking the usage of a metered price
- trial_
period_ numberdays - Default number of trial days when subscribing a customer to this price using
trial_from_plan=true. - usage_
type string - Configures how the quantity per period should be determined. Can be either
meteredorlicensed.licensedautomatically bills thequantityset when adding it to a subscription.meteredaggregates the total usage based on usage records. Defaults tolicensed.
- interval String
- The frequency at which a subscription is billed. One of
day,week,monthoryear. - interval
Count Double - The number of intervals (specified in the
intervalattribute) between subscription billings. For example,interval=monthandinterval_count=3bills every 3 months. - meter String
- The meter tracking the usage of a metered price
- trial
Period DoubleDays - Default number of trial days when subscribing a customer to this price using
trial_from_plan=true. - usage
Type String - Configures how the quantity per period should be determined. Can be either
meteredorlicensed.licensedautomatically bills thequantityset when adding it to a subscription.meteredaggregates the total usage based on usage records. Defaults tolicensed.
- interval string
- The frequency at which a subscription is billed. One of
day,week,monthoryear. - interval
Count number - The number of intervals (specified in the
intervalattribute) between subscription billings. For example,interval=monthandinterval_count=3bills every 3 months. - meter string
- The meter tracking the usage of a metered price
- trial
Period numberDays - Default number of trial days when subscribing a customer to this price using
trial_from_plan=true. - usage
Type string - Configures how the quantity per period should be determined. Can be either
meteredorlicensed.licensedautomatically bills thequantityset when adding it to a subscription.meteredaggregates the total usage based on usage records. Defaults tolicensed.
- interval str
- The frequency at which a subscription is billed. One of
day,week,monthoryear. - interval_
count float - The number of intervals (specified in the
intervalattribute) between subscription billings. For example,interval=monthandinterval_count=3bills every 3 months. - meter str
- The meter tracking the usage of a metered price
- trial_
period_ floatdays - Default number of trial days when subscribing a customer to this price using
trial_from_plan=true. - usage_
type str - Configures how the quantity per period should be determined. Can be either
meteredorlicensed.licensedautomatically bills thequantityset when adding it to a subscription.meteredaggregates the total usage based on usage records. Defaults tolicensed.
- interval String
- The frequency at which a subscription is billed. One of
day,week,monthoryear. - interval
Count Number - The number of intervals (specified in the
intervalattribute) between subscription billings. For example,interval=monthandinterval_count=3bills every 3 months. - meter String
- The meter tracking the usage of a metered price
- trial
Period NumberDays - Default number of trial days when subscribing a customer to this price using
trial_from_plan=true. - usage
Type String - Configures how the quantity per period should be determined. Can be either
meteredorlicensed.licensedautomatically bills thequantityset when adding it to a subscription.meteredaggregates the total usage based on usage records. Defaults tolicensed.
PriceTier, PriceTierArgs
- Up
To string - Up to and including to this quantity will be contained in the tier.
- Flat
Amount double - Price for the entire tier.
- Flat
Amount stringDecimal - Same as
flat_amount, but contains a decimal value with at most 12 decimal places. - Unit
Amount double - Per unit price for units relevant to the tier.
- Unit
Amount stringDecimal - Same as
unit_amount, but contains a decimal value with at most 12 decimal places.
- Up
To string - Up to and including to this quantity will be contained in the tier.
- Flat
Amount float64 - Price for the entire tier.
- Flat
Amount stringDecimal - Same as
flat_amount, but contains a decimal value with at most 12 decimal places. - Unit
Amount float64 - Per unit price for units relevant to the tier.
- Unit
Amount stringDecimal - Same as
unit_amount, but contains a decimal value with at most 12 decimal places.
- up_
to string - Up to and including to this quantity will be contained in the tier.
- flat_
amount number - Price for the entire tier.
- flat_
amount_ stringdecimal - Same as
flat_amount, but contains a decimal value with at most 12 decimal places. - unit_
amount number - Per unit price for units relevant to the tier.
- unit_
amount_ stringdecimal - Same as
unit_amount, but contains a decimal value with at most 12 decimal places.
- up
To String - Up to and including to this quantity will be contained in the tier.
- flat
Amount Double - Price for the entire tier.
- flat
Amount StringDecimal - Same as
flat_amount, but contains a decimal value with at most 12 decimal places. - unit
Amount Double - Per unit price for units relevant to the tier.
- unit
Amount StringDecimal - Same as
unit_amount, but contains a decimal value with at most 12 decimal places.
- up
To string - Up to and including to this quantity will be contained in the tier.
- flat
Amount number - Price for the entire tier.
- flat
Amount stringDecimal - Same as
flat_amount, but contains a decimal value with at most 12 decimal places. - unit
Amount number - Per unit price for units relevant to the tier.
- unit
Amount stringDecimal - Same as
unit_amount, but contains a decimal value with at most 12 decimal places.
- up_
to str - Up to and including to this quantity will be contained in the tier.
- flat_
amount float - Price for the entire tier.
- flat_
amount_ strdecimal - Same as
flat_amount, but contains a decimal value with at most 12 decimal places. - unit_
amount float - Per unit price for units relevant to the tier.
- unit_
amount_ strdecimal - Same as
unit_amount, but contains a decimal value with at most 12 decimal places.
- up
To String - Up to and including to this quantity will be contained in the tier.
- flat
Amount Number - Price for the entire tier.
- flat
Amount StringDecimal - Same as
flat_amount, but contains a decimal value with at most 12 decimal places. - unit
Amount Number - Per unit price for units relevant to the tier.
- unit
Amount StringDecimal - Same as
unit_amount, but contains a decimal value with at most 12 decimal places.
PriceTransformQuantity, PriceTransformQuantityArgs
Package Details
- Repository
- stripe stripe/terraform-provider-stripe
- License
- Notes
- This Pulumi package is based on the
stripeTerraform Provider.
published on Friday, Aug 14, 2026 by Pulumi