PUT
/
price-plans
/
{id}

Authorizations

Authorization
string
headerrequired

Value for the Authorization header parameter.

Path Parameters

id
string
required

PricePlan identifier

Body

product
string
required

The product this price plan belongs to.

type
enum<string>
required

The type of the charge. This defines how the price is calculated.

Possible values:

  • flat_fee: A flat fee is charged, e.g. 10€ per month independent of the number of units.
  • volume: A volume based price is charged, e.g. 10€ for the first 10 units and 9€ for all units when the number of units is above 10. Useful for volume discounts.
  • percentage: A percentage of the total price is charged, e.g. 10% of the total price multiplied by the number of units. Useful for provisions.
  • per_unit: A price per unit is charged, e.g. 10€ per unit per billing interval. Useful for per seat based pricing.
  • tiered: A tiered price is charged. E.g. 10€ per unit for the first 10 units, 9€ per unit for the next 10 units and 8€ per unit for all units above 20.
  • stair_step: A stair step price is charged. E.g. 10€ per unit for the first 10 units, 9€ per unit for all units above 10.
Available options:
flat_fee,
per_unit,
tiered,
volume,
stair_step,
percentage
billingInterval
any
currencyCode
string
required

The currency of the price

price
object
required

The price in the defined billing interval.

internalName
string | null

The internal name of the price plan.

Required string length: 3 - 255
customer
string | null

This price is only available for a specific customer. If this is set, the price is only available for the customer with the given ID. All other price plans will be ignored.

applyTrial
boolean
default: true

If this is set to true, the price plan can be applied on a trial. If the product is in trial, and this is false, the price will be charged on subscription start, otherwise after trial.

payInAdvance
boolean | null
default: true

If this is set to true, the price will be charged in advance. If this is false, the price will be charged at the end of the billing interval.

proRata
boolean

If this is set to true, the price will be charged prorated when a partial billing interval is billed. This applies to measurements of type "recurring" or non-one-time billing intervals. For other measurements this parameter will be ignored.

freeUnits
any

Response

200 - application/json
type
enum<string>
required

The type of the charge. This defines how the price is calculated.

Possible values:

  • flat_fee: A flat fee is charged, e.g. 10€ per month independent of the number of units.
  • volume: A volume based price is charged, e.g. 10€ for the first 10 units and 9€ for all units when the number of units is above 10. Useful for volume discounts.
  • percentage: A percentage of the total price is charged, e.g. 10% of the total price multiplied by the number of units. Useful for provisions.
  • per_unit: A price per unit is charged, e.g. 10€ per unit per billing interval. Useful for per seat based pricing.
  • tiered: A tiered price is charged. E.g. 10€ per unit for the first 10 units, 9€ per unit for the next 10 units and 8€ per unit for all units above 20.
  • stair_step: A stair step price is charged. E.g. 10€ per unit for the first 10 units, 9€ per unit for all units above 10.
Available options:
flat_fee,
per_unit,
tiered,
volume,
stair_step,
percentage
billingInterval
any
currencyCode
string
required

The currency of the price

price
object
required

The price in the defined billing interval.

id
string

The unique identifier of the price plan.

internalName
string | null

The internal name of the price plan.

Required string length: 3 - 255
status
enum<string>
default: active

The status of the price plan.

Possible values:

  • active: The price is active and can be used.
  • archived: The price is archived and cannot be used anymore. It will be not shown in any lists until explicitly requested.
Available options:
active,
archived
salesChannel
object

This price is only available for a specific sales channel. If this is set, the price is only available for the sales channel with the given ID. All other price plans will be ignored.

applyTrial
boolean
default: true

If this is set to true, the price plan can be applied on a trial. If the product is in trial, and this is false, the price will be charged on subscription start, otherwise after trial.

payInAdvance
boolean | null
default: true

If this is set to true, the price will be charged in advance. If this is false, the price will be charged at the end of the billing interval.

proRata
boolean

If this is set to true, the price will be charged prorated when a partial billing interval is billed. This applies to measurements of type "recurring" or non-one-time billing intervals. For other measurements this parameter will be ignored.

freeUnits
any
custom
boolean

If this price plan is a custom price plan. A price plan is custom if it is defined specific for a plan addon, plan charge, customer or sales channel.

charge
string

The charge related to this price plan.

productSetOption
string

The product set option related to this price plan.

product
string

The product this price plan belongs to.

customer
string

The customer this price plan belongs to.

inUse
boolean

If this price plan is in use.

checkoutLinkIds
string[]

The checkout link IDs related to this price plan.

Was this page helpful?

Get a priceArchive a price plan